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I.    INTRODUCTION 

A.  BACKGROUND 

The  Multicast  Backbone  (MBone)  is  a  virtual  network  that  has  been  in  operation 
since  1992.  It  was  initially  used  to  multicast  audio  and  video  from  meetings  of  the 
Internet  Engineering  Task  Force,  but  nowadays  it  has  become  a  shared  worldwide 
medium  with  many  diverse  channels  for  Internet  multicast  communications  (Macedonia, 
et  al.,  94). 

The  Real-time  Transport  Protocol  (RTP)  was  developed  to  support  time-based 
media,  such  as  audio  and  video,  over  multicast-capable  networks  (Schulzrinne,  et  al.,  99). 
RTP  is  the  basic  packet  header  format  for  MBone  application  streams.  Using  RTP,  a 
multicast  session  between  several  participants  can  be  established,  making  possible  the 
correct  synchronization  of  the  exchanged  media  and  the  feedback  of  each  participant 
about  the  quality  of  reception.  The  RTP  Control  Protocol  (RTCP)  performs  the  feedback 
and  control  mechanisms  of  RTP. 

Java  Media  Framework  (JMF)  is  a  new  Java  Application  Programming  Interface 
(API)  developed  by  Sun  and  other  companies  to  allow  Java  programmers  use  multimedia 
features  in  applications  and  applets  (Sun,  99).  JMF  supports  RTP  transmission  and 
reception  of  audio  and  video  streams.  This  thesis  examines  network-monitoring  issues 
relevant  to  RTP  through  implementation  and  testing  of  a  JMF  application. 

B.  MOTIVATION 

Since  its  inception,  RTP  has  been  mostly  used  in  audio  and  video  conferences. 
However,  a  diverse  set  of  multicast  applications  can  take  benefit  of  RTP  mechanisms  for 
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synchronization,  such  as  exchanging  simulation  data  over  a  wide-area  network  (WAN). 
RTP  is  particular  important  because  it  is  used  by  backbone  routers  to  support  Quality  of 
Service  (QoS)  related  performance  optimization. 

The  Virtual  Reality  Transfer  Protocol  (vrtp)  is  developed  to  provide  client,  server, 
multicast  streaming  and  network-monitoring  capabilities  in  support  of  internetworked  3D 
graphics  and  large-scale  virtual  environments  (LSVEs)  (Brutzman,  99).  RTP  is  an 
integral  part  of  the  vrtp  architecture,  used  in  both  the  streaming  and  monitoring 
components. 

JMF  is  a  possible  solution  for  the  implementation  of  the  RTP  protocol  in  vrtp. 
JMF  is  a  free  package  and  is  an  approved  extension  of  the  Java  language  application 
programming  interface  (API). 

C.         OBJECTIVES 

The  goal  of  this  thesis  is  the  implementation  of  a  monitor  application  for  the  Real- 
time Transport  Protocol  (RTP)  using  Java  Media  Framework  (JMF).  An  RTP  monitor  is 
an  application  that  receives  packets  sent  by  all  participants  in  order  to  estimate  the  quality 
of  service  for  distribution  monitoring,  data  recording,  statistics  analysis  and  fault 
diagnosis  (Schulzrinne,  et  al.,  99).  The  emphasis  is  in  both  short-term  and  long-term 
statistics  by  having  recording  capabilities  for  future  analysis.  As  a  result  of  this  work,  an 
example  set  of  classes  for  monitoring  RTP  sessions  can  be  provided  to  vrtp  applications. 


D.         THESIS  ORGANIZATION 

The  remaining  chapters  of  this  thesis  are  organized  as  follows.  Chapter  II 
describes  work  related  to  RTP  monitoring.  Chapter  III  presents  the  RTP  protocol 
functionality  and  packet  formats.  Chapter  IV  provides  an  overview  of  the  JMF 
architecture  with  emphasis  on  the  RTP  classes.  Chapter  V  describes  the  design  and 
implementation  of  the  RTP  monitor  application,  and  the  interdependency  between  the 
RTP  Monitor  and  JMF  classes.  Chapter  VI  contains  a  study  of  compatibility  between 
JMF  statistics  and  the  proposed  RTP  Management  Information  Base  (MIB)  (Baugher,  et 
al.,  99).  Chapter  VII  contains  the  experimental  results  achieved  and  problems  observed. 
Finally,  Chapter  VIII  presents  conclusions  and  provides  recommendations  for  future 
work. 
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II.    RELATED  WORK 

A.  INTRODUCTION 

This  chapter  presents  some  related  work  in  the  area  of  RTP  monitoring.  RTP 
monitoring  is  closely  related  to  the  RTCP  protocol,  but  some  applications  discussed  here 
combine  RTCP  data  with  multicast  route  tracing,  improving  the  monitoring  quality. 
Applications  are  considered  in  into  two  categories:  media  conference  applications  with 
monitoring  features,  and  dedicated  monitors.  This  chapter  also  contains  pertinent 
information  about  the  vrtp  protocol  and  the  Internet  2  Surveyor  project. 

B.  RTP  MONITORING  IN  MEDIA  CONFERENCE  APPLICATIONS 

Most  conference  applications  used  in  MBone  can  display  some  sort  of  RTP 
monitoring  data.  As  the  emphasis  of  these  applications  is  media  presentation  and  stream 
quality  assessment,  the  statistical  data  is  usually  not  enough  for  network  administration  or 
diagnostic  purposes.  The  RTP  statistics  features  of  some  conference  applications  are 
described  here. 

1.  Video  Conferencing  Tool  (VIC) 

VIC  is  a  video  conferencing  application  developed  by  the  Network  Research 
Group  at  the  Lawrence  Berkeley  National  Laboratory  (LBNL)  in  collaboration  with  the 
University  of  California,  Berkeley  (UCB).  The  software  was  improved  by  University 
College  of  London  (UCL).  The  latest  version  is  2.8ucl4.  (UCL,  99) 

The  RTP  statistics  window  of  each  VIC  video  stream  consists  of  a  grid  with 
three  columns  (Figure  2.1).  The  first  column,  EWA  (Exponentially  Weighted  Average),  is 


the  change  since  the  last  sampling  period  (i.e.  change  over  the  last  second);  the  middle 
column,  Delta,  is  a  smoothed  version  of  the  EWA;  and  the  last  column,  Total,  is  the 
accumulated  value  since  start-up.  Clicking  any  of  the  buttons  in  the  left  column  opens  a 
Plot  Window  displaying  the  statistics  for  that  parameter  graphically.  (UCL,  99) 
Figure  2.1  contains  example  RTP  statistics  for  video  VIC  streams. 
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Figure  2.1  RTP  Statistics  in  VIC  showing  video  stream, 
available  statistics  (right  side)  and  a  10-second  trace  of  missing- 
packet  data  (lower-left  corner).  Recorded  July  1999. 


2.  Robust  Audio  Tool  (RAT) 

RAT  is  an  audio  conference  application  developed  by  UCL.  The  latest  version  is 
4.0.3  (UCL,  99).  Figure  2.2  shows  an  example  of  RTP  statistics  available  in  RAT.  Each 
set  of  statistics  is  related  to  one  receiving  audio  stream. 
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Figure  2.2  RTP  Statistics  in  RAT. 


C.         DEDICATED  MONITORS 


1.  Mtrace 


Mtrace  allows  the  user  trace  a  route  from  a  receiver  to  a  source  working 
backwards  using  a  particular  multicast  address.  It  runs  only  on  Unix  systems.  If 
either  the  receiver  or  the  source  is  not  participating  in  a  multicast  on  the  specified 
address  then  mtrace  may  not  work.  Vic  and  vat  can  automatically  launch  the 
mtrace  utility.  Mtrace  is  included  in  the  mrouted  distribution  and  can  be 
downloaded  at  the  following  site: 

http://www.cs.unc.edU/~wangx/MBONE/mbonetoolarchive.html#mtrace 

2.  Session  Directory  (SDR)  Monitor 

SDR  Monitor,  short  for  SDR  Global  Session  Monitoring  Effort,  is  an 
effort  to  track,  manage,  and  present  information  about  the  availability  of  world- 
wide multicast  sessions  using  the  SDR  tool  (Sarac,  99).  SDR  is  a  session  directory 
tool  designed  to  allow  the  advertisement  and  joining  of  multicast  conferences  on 
the  MBone  (UCL,  99). 

The  basic  idea  of  the  SDR  Monitor  is  that  the  SDR  application  can 
periodically  send  an  an  email  to  the  project  control  containing  all  the  session 
announcements  that  are  being  received  at  the  user  site.  All  data  collected  is  made 
available  in  world-wide-web  page,  using  a  tabulated  form  that  conveys 
information  about  the  session  reachability. 


3.  Rtpmon 

Rtpmon  is  a  third-party  RTP  monitor  written  in  C++  by  the  Plateau  Multimedia 
Research  Group  at  Berkeley.  Version  1.0  was  the  last  release  in  1996.  It  works  only  on 
Unix  systems.  Both  source  code  and  binaries  are  available.  It  is  possible  to  integrate 
rtpmon  with  vie  and/or  vat  by  modifying  the  files  .vic.tcl  and/or  .vat.tcl.  This  will  add  a 
monitor  button  to  vie  and  vat  that  when  pressed  will  launch  rtpmon.  (Agarwal,  97) 

Rtpmon  provides  a  number  of  useful  capabilities  for  sorting,  filtering  and 
displaying  the  statistics  generated  in  an  RTP  session  (David,  96).  Figure  2.3  shows  an 
example  of  the  rtpmon  Graphical  User  Interface  (GUI).  It  displays  RTCP  statistics  in  a 
table  with  senders  listed  along  the  top  and  listeners  along  the  left.  Each  entry  in  the  table 
corresponds  to  the  data  obtained  about  a  single  sender-receiver  pair.  The  program  listens 
to  RTCP  messages  on  a  multicast  address  specified  at  startup  time;  there  is  no  provision 
for  displaying  data  from  multiple  sessions.  Information  about  each  participant  can  be 
obtained  by  clicking  the  participant's  name  in  the  table  display;  doing  so  brings  up  a 
window  with  the  session  description  items  provided  in  the  member's  RTCP  reports.  The 
information  window  also  contains  a  button,  which  spawns  mtrace  for  detailed  single- 
sender- receiver  multicast  routing  data.  Rtpmon  can  also  display  a  brief  history  of  the 
statistics  from  each  sender-receiver  pair.  Clicking  on  a  data  element  in  the  main  table 
brings  up  charts  for  each  of  the  statistics  values  that  rtpmon  tracks. 
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Figure  2.3  Rtpmon  graphical  user  interface  (GUI). 
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4. 


MultiMON 


MultiMON  is  a  client/server  monitor  that  collects,  organizes  and  displays  all  the 
IP  multicast  traffic  that  is  detected  at  the  location  of  a  server  (Robinson,  et  al,  96).  It  was 
developed  by  the  Communications  Research  Center  at  Ottawa.  Last  release  was  version 
2.0  in  July  1998.  It  can  be  downloaded  at  ftp://debra.dgbt.doc.ca/pub/mbone/multimon/. 

MultiMON  is  a  general-purpose  multicast  monitoring  tool.  It  is  intended  to 
monitor  multicast  traffic  on  local-area  network  (LAN)  segments  and  assist  a  network 
administrator  in  managing  the  traffic  on  an  Intranet.  The  client  main  window  displays  the 
total  bandwidth  occupied  by  the  multicast  traffic  and  gives  a  graphical  breakdown  of  the 
traffic  by  application  type,  as  shown  in  Figure  2.4. 
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Figure  2.4  MultiMON  client  window  (Robinson,  et  al,  96). 
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The  software  includes  an  RTCP  monitoring  and  recording  tool  (MERCInari)  that 
allows  an  analysis  of  the  RTCP  data  for  QoS  management.  A  session  can  be  recorded  for 
later  analysis.  MultiMON  is  written  in  tk/tcl,  but  needs  tcpdump,  xplot,  the  distributed 
processing  additions  and  the  object-oriented  additions  to  tk/tcl.  It  runs  in  Sun 
workstations,  but  it  can  be  ported  to  other  platforms  including  Windows  95/98  and  NT. 

5.  MHealth 

MHealth,  the  Multicast  Health  Monitor,  is  a  graphical  multicast  monitoring  tool 
(Makofske,  et  al.,  99).  By  using  a  combination  of  application-level  protocol  data  for 
participant  information  and  a  multicast  route-tracing  tool  for  topology  information, 
MHealth  is  able  to  present  a  multicast  tree's  topology  and  information  about  the  quality 
of  received  data.  Figure  2.5  contains  a  screenshot  of  MHealth. 

MHealth  also  provides  data-logging  functionality  for  the  purpose  of  isolating  and 
analyzing  network  faults.  Logs  can  be  analyzed  to  provide  information  such  as  receiver 
lists  over  time,  route  histories  and  changes,  as  well  as  the  location,  duration,  and 
frequency  of  packet  loss  (Makofske,  et  al.,  99).  MHealth  was  written  in  Java  but  needs 
mtrace  for  its  operation.  Version  1 .0  can  be  downloaded  at: 
http://steamboat.cs.ucsb.edU/mhealth/download-vl.0/. 
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Figure  2.5  MHealth  display  showing  participants  in  a 
multicast  .tree  (Robinson,  et  al.,  96). 


D. 


VRTP 


The  Virtual  Reality  Transfer  Protocol  (vrtp)  is  a  protocol  being  developed  to 
provide  client,  server,  multicast  streaming  and  network-monitoring  capabilities  in  support 
of  internetworked  3D  graphics  and  large-scale  virtual  environments  (LSVEs)  (Brutzman, 
99).  vrtp  is  designed  to  support  interlinked  VRML  worlds  in  the  same  manner  as  http 
was  designed  to  support  interlinked  HTML  pages.  The  intent  is  to  develop  a  free  library 


to  provide  any  machine  with  client,  server,  peer-to-peer  and  network  monitoring 
capabilities  to  navigate  and  join  large,  interactive,  fully  internetworked  3D  worlds. 

RTP  is  an  integral  part  of  the  vrtp  architecture,  used  in  both  the  streaming  and 
monitoring  components.  Figure  2.6  shows  the  functional  design  of  the  vrtp  streaming 
behaviors  component. 
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Figure  2.6  vrtp  streaming  behaviors  component  (Brutzman,99). 
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E.  INTERNET  2  SURVEYOR 

The  university  community  has  joined  together  with  government  and  industry 
partners  to  accelerate  the  next  stage  of  Internet  development.  The  Internet2  project  is 
bringing  focus,  energy  and  resources  to  the  development  of  a  new  family  of  advanced 
applications  to  meet  emerging  academic  requirements  in  research,  teaching  and  learning 
(Advanced  Networks,  97). 

Surveyor  is  a  measurement  infrastructure  that  is  being  currently  deployed  at 
participating  sites  around  the  world.  Based  on  standards  work  being  done  in  the  Internet 
Engineering  Task  Force  (IETF),  Surveyor  measures  the  performance  of  the  Internet 
paths  among  partcipating  organizations.  The  project  is  also  developing  methodologies 
and  tools  to  analyze  the  performance  data.  The  project  aims  to  create  the  infrastructure 
and  tools  that  will  improve  the  ability  to  understand  and  effectively  engineer  the  Internet 
infrastructure  (Advanced  Networks,  97).  Surveyor  monitoring  workstations  installed  at 
NPS  are  expected  to  provide  a  controlled  network  environment  supporting  RtpMonitor 
work. 

F.  DESIGN  PATTERNS 

Design  Patterns  are  reusable  solutions  to  recurring  problems  that  occur  during 
software  development.  In  1995,  the  book  "Design  Patterns''  (Gamma,  95)  has  started 
popularizing  the  idea  of  patterns.  In  recent  years,  new  patterns  have  been  proposed  and 
several  books  about  patterns  have  been  released.  Frequently,  books  about  Design  Patterns 
give  examples  of  pattern  implementations  in  some  computer  language.  A  good  book  for 
studying  patterns  in  Java  was  written  by  Mark  Grand  (Grand,  98).  Sun  Microsystems' 
Java  Application  Programming  Interfaces  (APIs)  contain  plenty  of  examples  of  pattern 
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use.  Design  patterns  provided  great  benefit  during  the  software  analysis,  design  and 
implementation  work  in  this  thesis. 
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III.    REAL-TIME  TRANSPORT  PROTOCOL  (RTP) 

A.  INTRODUCTION 

This  chapter  presents  the  Real-time  Transport  Protocol  (RTP)  functionality  and 
packet  format.  RTP  is  a  header  format  and  control  protocol  designed  to  support 
applications  transmitting  real-time  data  (such  as  audio,  video,  or  simulation  data),  over 
multicast  or  unicast  network  services.  RTP  was  proposed  by  RFC  1889  (Schulzrinne,  et 
al.,  99)  and  has  received  wide  acceptance. 

B.  OVERVIEW  OF  TRANSPORT  RELATIONSHIPS 

The  transport  layer  provides  a  flow  of  data  between  hosts.  In  the  TCP/IP  protocol 
suite  there  are  two  vastly  different  transport  protocols:  the  Transmission  Control  Protocol 
(TCP)  and  the  User  Datagram  Protocol  (UDP).  While  TCP  provides  a  reliable  flow  of 
data  between  two  hosts,  by  using  packet  acknowledgements  and  retransmissions,  UDP 
just  sends  single  packets  with  no  guarantee  that  the  packets  will  be  received  at  the  other 
side. 

RTP  does  not  provide  all  the  functionality  required  by  a  transport  protocol.  It  is 
intended  to  run  over  some  transport  protocol,  such  as  UDP,  primarily  in  multicast  mode. 
TCP  is  not  suitable  for  real-time  audio/video  transfers  because  packet  loss  implies  in 
retransmissions  that  affect  delay-sensitive  data.  Also  TCP  does  not  support  multicasting. 
Despite  the  implication  of  its  name,  RTP  does  not  provide  any  means  to  ensure  timely 
delivery  or  to  guarantee  a  desired  quality  of  service.  In  fact,  RTP  was  designed  to  satisfy 
the  needs  of  multi-participant  multimedia  conferences,  where  the  loss  of  some  packets  or 
some  small  delay  will  not  affect  the  session  significantly. 
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Basically,  the  RTP  header  provides  a  sequence  number  and  a  timestamp  in  each 
packet,  allowing  the  timing  reconstruction  of  the  receiving  stream.  Additionally,  RTP 
header  specifies  a  payload  type,  allowing  different  data  formats  to  originate  from 
different  senders  in  a  single  session.  Further  parameters  in  the  RTP  packet  header  are 
defined  in  a  media-specific  manner. 

RTP  is  used  together  with  the  RTP  Control  Protocol  (RTCP),  which  provides 
mechanisms  of  synchronization,  source  identification  and  quality-of-service  feedback. 

C.         RTP 

This  section  summarizes  RTP,  which  is  formally  described  in  RFC  1889 
(Schulzrinne,  et  al.,  99). 

1.  RTP  Units:  Mixer,  Translator  and  Monitor 

A  Mixer  is  an  intermediate  system  that  receives  streams  of  RTP  data  packets  from 
one  or  more  sources,  possibly  changes  the  data  format,  combines  the  streams  in  some 
manner  and  then  forwards  the  combined  stream.  A  mixer  sends  its  data  just  as  if  it  were  a 
new  source. 

A  Translator  is  an  intermediate  system  that  forwards  packets  without  changing  its 
source  description.  Translators  can  be  used  as  devices  to  convert  encodings,  such  as 
replicators  from  multicast  to  unicast,  and  such  as  application  filters  in  firewalls. 

A  Monitor  is  an  application  that  receives  RTCP  packets  sent  by  all  participants  to 
estimate  the  quality  of  service  for  distribution  monitoring,  fault  diagnosis  and  long-term 
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statistics.  The  monitor  is  likely  to  be  built  into  the  applications  participating  in  a  session, 
but  it  may  also  be  a  separate  application  that  does  not  send  or  receive  RTP  data  packets 
such  as  third-party  monitors. 

RTP  is  designed  to  connect  several  end-systems  in  single  or  multiple  sessions.  An 
end-system  sends  and/or  receives  RTP  data  packets.  In  addition,  RTP  supports  the  notion 
of  Translators  and  Mixers,  which  can  be  considered  intermediate  systems  at  the  RTP 
level.  The  need  for  these  systems  has  been  established  by  experiments  with  multicast  and 
video  applications,  especially  for  dealing  with  low-bandwidth  connections  and  firewalls. 


2. 


RTP  Header 


A  RTP  header  precedes  each  RTP  packet.  Figure  3.1  represents  an  RTP  header. 
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cc 


PT 


seauence  number 


time st amp 


synchronization  source (SSRC)  identifier 


contributing  source  (CSRC)  identifiers 


Figure  3.1  RTP  Header  Contents  (Schulzrinne,  et  al.,  99). 


The  following  information  is  part  of  the  header: 

•  Version  (V):  2  bits  -  Identifies  the  version  of  RTP.  The  current  version 
defined  in  RFC  1889  is  two  (2). 

•  Padding  (P):  1  bit  -  If  the  padding  bit  is  set,  the  packet  contains  one  or  more 
additional  padding  bytes.  The  last  byte  contains  the  number  of  padding  bytes, 
including  itself.  The  RTP  header  has  no  packet  length  field. 
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• 


Extension  (X):  1  bit  -  If  this  bit  is  set  the  header  will  be  followed  by  a  header 
extension. 

CSRC  count  (CC):  4  bits  -  Contains  the  number  of  contributing  source 
identifiers  in  the  header. 

Marker  (M):  1  bit  -  Can  be  used  by  a  profile. 

Payload  type  (PT):  7  bits  -  Identifies  the  type  of  data  (payload)  carried  by  the 
packet.  The  payload  types  for  standard  audio  and  video  encodings  are  defined 
in  RFC  1890  (Schulzrinne,  99). 

Sequence  number:  1 6  bits  -  It  is  incremented  each  time  a  packet  is  sent.  The 
initial  value  is  randomly  generated. 

Timestamp:  32  bits  -  This  field  reflects  the  sampling  instant  of  the  first  byte  of 
data.  The  clock  frequency  depends  of  the  data  type.  For  example,  if  audio  data 
is  being  sampled  at  8KHz,  and  each  audio  packet  has  20  ms  of  samples  (160 
sample  values),  the  timestamp  should  be  increased  by  1 60  each  20  ms.  The 
timestamp  initial  value  should  be  random. 

SSRC:  32  bits  -  This  field  identifies  the  synchronization  source.  It  is  a  number 
chosen  randomly.  It  must  be  unique  among  all  participants  in  a  session.  There 
is  a  mechanism  to  solve  conflicts  when  two  sources  choose  the  same  number, 
described  in  Session  8  of  RFC  1889.  A  participant  need  not  use  the  same 
SSRC  identifier  in  all  sessions  of  a  multimedia  session. 

CSRC  list:  0  to  15  items,  32  bits  each  -  The  CSRC  list  identifies  the 
contributing  sources  for  the  payload  contained  in  this  packet.  It  is  used  only 
by  mixers,  which  combine  several  streams  from  different  sources  in  a  single 
stream. 


3.  Profiles  and  RTP  Header  Extension 

The  RTP  protocol  is  designed  to  be  malleable  and  to  allow  modifications  and 
additions  as  defined  by  the  corresponding  media  profile  specification.  Typically  each 
application  only  operates  under  one  profile.  For  example,  RFC  1890  (Schulzrinne,  et  al., 
99)  defines  a  profile  for  audio  and  video  conferences. 


• 
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In  the  RTP  fixed  header,  the  marker  bit  (M)  and  the  payload  type  (PT)  fields  carry 
profile-specific  information.  If  the  marker  bit  is  set,  a  header  extension  will  be  added  to 
the  RTP  fixed  header  to  provide  the  additional  data  functionality  required  for  the  profile. 

The  header  extension  has  the  following  format  seen  in  Figure  3.2. 


0                             16 

31 

defined  by  the  profile 

Length 

(#  of  32-bit  words) 

header  extension  data 

Figure  3.2  RTP  Header  Extension  (Schulzrinne,  et  al.,  99). 

The  length  field  defines  the  number  of  32-bit  words  of  the  header  extension, 
excluding  the  first  one.  Therefore,  zero  is  a  possible  value.  Only  a  single  variable-length 
header  extension  can  be  appended  to  the  RTP  header. 

D.         RTP  SESSION  ADDRESSING 

A  session  is  an  association  among  participants.  It  is  defined  by  two  transport 
parameter  pairs  (two  network  addresses  plus  corresponding  port  numbers).  One  transport 
address  is  used  for  transmitting  RTP  packets  and  the  other  is  used  for  RTCP  packets.  The 
destination  transport  address  pair  may  be  the  same  for  all  participants  when  using 
multicast,  or  may  be  different  for  each  when  using  unicast.  For  multicast  UDP,  the 
multicast  address  for  RTP  and  RTCP  in  a  session  must  be  the  same,  the  RTP  port  must  be 
even,  and  the  RTCP  port  must  be  the  next  higher  (odd)  port  number.  Multiple  RTP 
sessions  are  distinguished  by  different  port  number  pairs  and/or  different  multicast 
addresses. 
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Some  applications  like  audio  and  videoconferences  require  the  use  of  two 
sessions:  one  for  audio  and  the  other  for  video.  Distinct  media  types  should  not  be  carried 
in  a  single  session,  because  of  the  different  timing  and  bandwidth  requirements. 

Figure  3.3  shows  three  different  multicast  conferences  configurations.  Part  a)  is  a 
single  media  conference,  represented  by  a  single  session.  Part  b)  and  c)  represent  two 
possible  configurations  for  a  conference  with  two  types  of  media,  e.g.  audio  and  video. 

E.    RTP  CONTROL  PROTOCOL  (  RTCP) 

RTCP  provides  back-channel  monitoring  and  synchronization  for  use  with  RTP 
streams.  RTCP  provides  a  periodic  transmission  of  control  packets  to  all  participants  in 
the  session.  RTCP  performs  the  following  functions: 


• 


Feedback  on  the  quality  of  the  data  distribution.  Receivers  must  periodically 
send  RTCP  packets  containing  a  set  of  information  related  to  the  quality  of 
each  sender  transmission,  such  as  the  number  of  lost  packets,  fraction  of  lost 
packets,  delay  times  and  jitter  (variations  in  delay). 

Provides  information  about  the  participants  in  the  session.  Each  participant 
must  periodically  send  their  canonical  name  (CNAME),  e-mail  address, 
telephone  number  and  so  on.  The  canonical  name  must  be  unique  among  the 
participants  of  a  multimedia  session  (a  group  of  sessions).  The  CNAME  is 
sent  together  with  the  SSRC  identifier,  allowing  the  detection  of  any  collision 
in  choosing  the  SSRC  identifier  in  a  session. 

Media  synchronization.  RTCP  conveys  information  about  the  absolute  time 
(wallclock)  for  each  participant.  If  the  senders  are  synchronized,  it  will  be 
possible  to  synchronize  the  different  media  in  a  session. 
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a) 
port  1  -  RTP 
port  2  -RTCP 

b) 

port  1  -  RTP  audio 
port  2  -  RTCP  audio 

port  3  -  RTP  video 
port  4  -  RTCP  video 

c) 

port  1  -  RTP  audio 
port  2  -  RTCP  audio 

port  3  -  RTP  video 
port  4  -  RTCP  video 


multicast 
address 


multicast 
address 


port  1  -RTP 
port  2  -RTCP 


port  1  -  RTP  audio 
port  2  -  RTCP  audio 
port  3  -  RTP  video 
port  4  -  RTCP  video 


port  1  -  RTP  audio 
port  2  -  RTCP  audio 

port  3  -  RTP  video 
port  4  -  RTCP  video 


Figure  3.3  RTP  Addressing  Configuration  Examples. 
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As  all  participants  must  send  RTCP  packets,  the  rate  must  be  controlled  to  avoid 
excessive  RTCP  traffic  as  the  number  of  participants  scales  up.  This,  each  participant 
must  control  his  RTCP  rate  to  guarantee  that  RTCP  packets  correspond  to  less  than  5%  of 
the  RTP  session.  Also,  it  is  recommended  that  at  least  Va  of  the  RTCP  bandwidth  would 
be  dedicated  to  senders.  When  the  proportion  of  senders  is  greater  than  V*  of  the 
participants,  the  sender  gets  its  proportion  from  the  full  RTCP  bandwidth.  It  is  further 
recommended  that  the  interval  between  RTCP  transmissions  by  each  participant  should 
always  be  greater  than  5  seconds. 

RFC  1889  defines  five  types  of  RTCP  packets: 

•  SR:    Sender   Report,    for   transmission    and    reception   of   statistics    from 
participants  that  are  active  senders. 

•  RR:  Receiver  Report,  for  reception  statistics  from  participants  that  are  not 
active  senders. 

•  SDES:  Source  Description,  for  each  participant  transfer  information  about 
himself. 

•  BYE:  to  notify  the  end  of  participation. 

•  APP:  application  specific  functions. 

Multiple  RTCP  packets  need  to  be  concatenated  without  any  separator  to  form  a 
compound  RTCP  packet.  Each  participant  must  send  RTCP  compound  packets  with  at 
least  one  SR  or  RR  and  one  SDES  with  his  CNAME. 

1.  Sender  Report  (SR) 

A  Sender  Report  is  issued  if  the  participant  has  sent  any  RTP  data  packets  since 
the  last  report,  otherwise  a  Receiver  Report  (RR)  is  issued.  A  sender  report,  besides 
having  statistical  information  about  itself,  may  contain  reception  statistics  of  a  maximum 
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of  31  other  senders.  If  a  sender  has  more  than  31  receiver  statistics  to  send  then,  it  must 

add  a  RR  to  the  compound  packet.  The  format  of  the  Sender  Report  is  shown  in  Figure 

3.4. 

The  Sender  Report  packet  consists  of  three  sections:  a  header  section,  a  sender 

information  section,  and  a  receiver  information  section.  A  fourth  profile-specific 

extension  section  can  be  defined.  The  fields  have  the  following  meaning: 

•     Version  (V):  2  bits  -  Identifies  the  version  of  RTP.  The  version  defined  in 
RFC1889istwo(2). 
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Figure  3.4  RTCP  Sender  Report  (SR)  Format  (Schulzrinne,  et  al.,  99). 
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,     Padding  (P):  1  bit  -  If  padding  bit  is  set,  the  packet  contains  one  or  more 
additional  padding  bytes.  The  last  byte  contains  the  number  of  padding  bytes, 
including  itself.  The  padding  bytes  are  included  in  the  length  field.  Only  the 
last  packet  of  a  compound  packet  can  use  padding. 

#  Reception  report  count  (RC):  5  bits  -  The  number  of  reception  report  blocks 
contained  in  this  packet. 

.     Packet  type  (PT):  8  bits  -  It  is  set  to  200  to  identify  a  SR  packet. 

,     Length:  16  bits  -    The  length  of  the  SR  packet  in  32-bit  words  minus  one, 
including  the  header  and  any  padding. 

9     SSRC:  32  bits  -  The  synchronization  source  identifier  for  this  originator  of 
this  SR  packet. 

.     NTP  timestamp:  64  bits  -  Indicates  the  wallclock  time  when  this  report  is 
sent.  The  wallclock  represents  the  absolute  day  and  time  using  the  timestamp 
format  of  the  Network  Time  Protocol  (NTP),  described  in  RFC  1305.  The  full 
resolution  NTP  timestamp  is  a  64  bit  unsigned  number  with  32  bits  for  the 
integer  part  and  32  bits  for  the  fractional  part.  It  represents  the  number  of 
seconds  relative  to  Oh  UTC  on  1  January  1900. 

9     RTP  timestamp:  32  bits  -  Corresponds  to  the  same  time  as  the  NTP  timestamp 
above,  but  in  the  same  units  and  with  the  same  random  offset  as  the  RTP 
timestamp  in  data  packets.  This  correspondence  may  be  used  for  intra-media 
and  inter-media  synchronization  for  sources  whose  NTP  timestamps  are 
synchronized. 

#  Sender's  packet  count:  32  bits  -  The  total  number  of  packets  transmitted  by 
the  sender  since  starting  transmission  until  the  time  the  SR  packet  was 
generated.  The  count  should  be  reset  if  the  sender  changes  its  SSRC  identifier. 

#  Sender's  byte  count:  32  bits  -  The  total  number  of  payload  octets  (i.e.  not 
including  header  or  padding)  transmitted  in  the  RTP  data  by  the  sender  since 
starting  the  transmission  until  this  SR  packet  was  generated.  The  count  should 
be  reset  if  the  sender  changes  its  SSRC  identifier. 

m     SSRC_n:  32  bits  -  The  SSRC  identifier  of  the  source  to  which  the  information 
in  this  block  pertains. 

#  Fraction  lost:  8  bits  -  The  fraction  of  RTP  data  packets  from  source  SSRC_n 
lost  since  the  previous  SR  or  RR  packet.  It  is  represented  as  a  fixed-point 
number  with  the  binary  point  at  the  left  edge  of  the  field. 
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•  Cumulative  number  of  packets  lost:  24  bits  -  The  total  number  of  RTP  data 
packets  from  source  SSRC_n  that  have  being  lost  since  the  beginning  of  the 
reception. 

•  Extended  highest  sequence  number  received:  32  bits  -  The  low  16  bits  contain 
the  highest  sequence  number  received  in  an  RTP  data  packet  from  source 
SSRC_n.  The  most  significant  16  bits  extend  that  sequence  number  with  the 
corresponding  count  of  sequence  number  cycles. 

•  Interarrival  jitter:  32  bits  -  An  estimate  of  the  statistical  variance  of  the  RTP 
data  packet  interarrival  time,  measured  in  timestamp  units  and  expressed  as  an 
unsigned  integer. 

•  Last  SR  timestamp  (LSR):  32  bits  -  The  middle  32  bits  out  of  64  bits  in  the 
NTP  timestamp  received  as  part  of  the  most  recent  RTCP  SR  packet  from  the 
source  SSCR_n. 

•  Delay  since  last  SR  (DLSR):  32  bits  -  The  delay,  expressed  in  units  of 
1/65536  seconds,  between  receiving  the  last  SR  packet  from  source  SSRC_n 
and  sending  this  reception  report  block.  Based  on  this  information  and  the 
LSR  the  sender  can  compute  the  round  trip  propagation  delay  to  this  receiver. 
This  can  be  done  by  the  following  formula:  Round  Trip  =  A-  LSR-  DLSR, 
where  A  is  the  time  the  receiver  gets  the  RR  message.  Figure  3.5  is  a  time 
diagram  that  represents  the  DLSR. 


2.  Receiver  Report  (RR) 

The  format  of  the  Receiver  Report  (RR)  is  the  same  of  the  Sender  Report  (SR) 
except  that  the  packet  type  field  contains  the  value  201  and  that  there  is  no  sender 
information  section. 

An  empty  RR  packet  (RC=0)  must  be  put  at  the  head  of  a  compound  packet  when 
there  is  no  data  transmission  or  reception  to  report.  Figure  3-6  shows  the  Receiver  Report 
packet  format.  Figure  3.6  represents  a  Receiver  Report  packet  format. 


27 


Figure  3.5  Delay  Since  Last  SR  (DLSR)  Time  Diagram. 
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Figure  3.6  Receiver  Report  (RR)  Format  (Schulzrinne,  et  al.,  99). 


3.  Source  Description  (SDES) 

The  SDES  packet  consists  of  a  header  section  and  zero  or  more  chunks  of  data. 
Each  chunk  is  composed  of  items  describing  the  source  identified  in  that  chunk.  The 
SDES  packet  format  is  shown  in  Figure  3.7. 
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Figure  3.7  Source  Description  (SDES)  Packet  Format  (Schulzrinne,  et  al.,  99). 

The  fields  in  the  SDES  packet  are: 

•  Version  (V),  Padding  (P)  and  length  -  As  described  for  SR  and  RR  packets. 

•  Packet  type  (PT):  8  bits  -  It  is  set  to  202  to  identify  a  SDES  packet. 

•  Source  count  (  SC):  5  bits  -  The  number  of  SSRC/CRCS  chunks  contained  in 
this  packet. 

The  SDES  item  format  is  shown  in  Figure  3.8. 

8  16  n 


type 

length 

content 

Figure  3.8  SDES  Item  Format  (Schulzrinne,  et  al.,  99). 
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The  fields  in  each  SDES  item  are: 

•  Type:  8  bits  -  Contains  a  value  to  identify  a  type  of  description.  The  following 
values  are  defined  in  RFC  1889: 

Canonical  Name  -  1 

Name -2 

Email  -3 

Phone  -  4 

Location  -  5 

Tool  -  6 

Note  -  7 

Private  Extensions  -  8 

•  Length:  8  bits  -  The  length  of  the  chunk  content,  in  bytes. 

•  Content  -    Consists  of  text  encoded  in  UTF-8  encoding  specified  in  RFC2279. 
This  field  is  continuous  and  it  is  not  limited  to  a  32-bit  boundary.  The  field 
must  be  terminated  with  a  null  octet,  and  followed  by  zero  or  more  null  octets 
until  the  next  32-bit  boundary.  This  kind  of  padding  is  separated  from  the  one 
specified  with  the  Padding  bit  in  the  header. 

Canonical  name  is  the  only  mandatory  SDES  item.  It  must  be  sent  on  each  RCTP 

packet.  As  the  canonical  name  will  be  used  to  identify  a  participant  in  single  and  multiple 

RTP  sessions,  it  must  be  unique.  CNAME  will  be  use  to  solve  collisions  with  the  SSRC 

identifiers.  A  participant  may  have  multiple  SSCR  identifiers,  one  for  each  related 

session  he  is  in,  but  he  must  have  only  one  CNAME.  As  CNAME  should  provide 

information  in  order  to  locate  a  source,  its  recommended  formats  are  user@full  hostname 

or  user@IPaddress. 
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4.  Goodbye  (BYE) 

The  BYE  packet  indicates  that  one  or  more  participants  are  no  longer  active.  The 
packet  has  the  format  shown  in  Figure  3.9. 


16 
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Figure  3.9  BYE  Packet  Format  (Schulzrinne,  et  al.,  99). 

The  header  section  has  the  same  format  of  the  previous  RTCP  packets.  Following 
the  header  there  is  list  of  all  participants  that  are  leaving  the  section.  The  reason  for 
providing  the  capability  for  more  than  one  source  in  the  BYE  packet  is  the  Goodbye 
packet  sent  by  a  mixer.  If  a  mixer  shuts  down,  it  must  send  a  BYE  packet  listing  its  SSRC 
and  the  CSRC  of  all  sources  it  handles. 

The  last  section  is  optional.  It  gives  a  reason  by  leaving  a  section,  like  "bad 
reception"  or  "time  for  lunch."  The  "length"  and  "reason  for  leaving"  fields  have  the 
same  behavior  as  "length"  and  "context"  fields  of  the  SDES  item. 
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F.         MULTIMEDIA  IN  RTP 

Each  media  must  be  carried  in  a  distinct  RTP  session.  Interleaving  packets  with 
different  RTP  media  types  but  using  the  same  session  and  SSRC  is  not  permitted,  in  order 
to  avoid  the  following  problems: 

•  An  SSRC  has  only  one  single  timing  and  sequence  number.  Different  payload 
types  would  require  distinct  timing  spaces.  Also  there  would  be  no  means  to 
identify  which  media  suffered  losses. 

•  The  RTCP  sender  and  receiver  reports  can  only  describe  one  timing  and  sequence 
number  space  per  SSRC  and  do  not  carry  a  payload  type  field. 


• 


An  RTP  mixer  would  not  be  able  to  combine  interleaved  streams  of  incompatible 
media  onto  one  stream. 

It  would  not  be  possible  to  use  different  network  paths  or  resource  allocations  for 
each  media. 


G.         ANALYSIS  OF  SR  AND  RR  REPORTS 

It  is  expected  that  reception  quality  feedback  data  will  be  useful  not  only  for  the 
senders  but  also  for  receivers  and  third-part  monitors.  The  senders  can  modify  its 
transmission  based  of  the  feedback;  receivers  can  determine  where  the  problems  are 
local,  regional  or  global;  network  managers  may  use  profile-independent  monitors  that 
receive  only  the  RTCP  packets  and  not  the  corresponding  RTP  data  streams  to  evaluate 
the  performance  of  their  networks  for  multicast  distribution.  These  mechanisms  also 
support  protective  and  corrective  mechanisms  such  as  congestion  avoidance  and 
congestion  control. 

The  interarrival  jitter  field  provides  a  short-term  measure  of  network  congestion. 
The  packet  loss  metric  tracks  persistent  congestion,  while  the  jitter  measure  tracks 
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transient  congestion.  The  jitter  measure  may  indicate  congestion  condition  forming 
before  it  leads  to  packet  loss. 

H.         RTP  PROFILES  AND  PAYLOAD  FORMAT  SPECIFICATIONS 

RTP  is  intended  to  be  tailored  through  modifications  and/or  additions  to  the 
headers  as  needed.  Multiple  profiles  have  been  defined,  each  with  different 
characteristics.  Therefore,  for  a  given  application,  a  complete  specification  will  require 
one  or  more  companion  documents,  as  follows. 

1.  Profile  Specification  Documents 

A  Profile  Specification  Document  defines  a  set  of  payload  type  codes  and  their 
mapping  to  payload  types.  A  profile  may  also  define  extensions  or  modifications  to  RTP 
that  are  specific  for  that  kind  of  applications.  The  only  profile  document  issued  as  of  this 
writing  is  RFC  1 890  -  RTP  Profile  for  Audio  and  Video  Conferences  with  Minimal 
Control. 

2.  Payload  Format  Specification  Documents 

A  Payload  Format  Specification  Document  defines  how  a  particular  payload,  such 
an  audio  or  video  encoding,  is  to  be  carried  in  RTP.  There  is  an  Internet-Draft  containing 
guidelines  to  be  followed  by  Payload  Format  Specification  Documents  (Handley,  99). 
Several  payload  format  specifications  were  proposed  so  far,  most  of  them  related  to  audio 
and  video  encodings.  Below  is  a  list  of  payload  format  RFCs  and  Internet-Drafts: 

•  RFC  2032  -  RTP  Payload  Format  for  H.261  Video  Streams. 

•  RFC  2029  -  RTP  Payload  Format  of  Sun's  CellB  Video  Encoding. 

•  RFC  2 1 90  -  RTP  Payload  Format  for  H.263  Video  Streams. 

•  RFC  2 1 98  -  RTP  Payload  for  Redundant  Audio  Data. 
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RFC  2250  -  RTP  Payload  Format  for  MPEG1/MPEG2  Video. 
RFC  2343  -  RTP  Payload  Format  for  Bundled  MPEG. 

RTP  Payload  Format  for  the  1998  Version  of  ITU-T  Rec.  H.263 


RFC  2429 
Video. 
RFC  2431 
RFC  2435 


RTP  Payload  Format  for  BT.656  Video  Encoding. 

RTP  Payload  Format  for  JPEG  Compressed  Video. 
RTP  Payload  for  Dial-Tone  Multi-Frequency  (DTMF)  Digits. 
RTP  Payload  Format  for  X  Protocol  Media  Streams. 
RTP  Payload  Format  for  MPEG-4  Streams. 
RTP  Payload  Format  for  User  Multiplexing. 
RTP  Payload  Format  for  Reed-Solomon  Codes. 
RTP  Payload  Format  for  Interleaved  Media. 
RTP  Payload  Format  for  Telephone  Signal  Events. 
RTP  Payload  Format  for  DVD  Format  Video. 


Other  RTP  related  RFCs  and  Internet-Drafts  include: 


RFC  2354  -  Options  for  Repair  of  Streaming  Media. 

RFC  2508  -  Compressing  IP/UDP/RTP  Headers  for  Low-Speed  Serial  Links. 

Real-Time  Protocol  Management  Information  Base. 

Sampling  the  Group  Membership  in  RTP. 

Issues  and  Options  for  RTP  Multiplexing. 

Conformance  Texts  for  RTP  Scalability  Algorithms. 

RTP  Testing  Strategies. 


I. 


SUMMARY 


The  Real-Time  Transport  Protocol  (RTP)  provides  a  way  to  transmit  time-based 
media  over  wide-area  networks  (WAN),  adding  synchronization  and  feedback  features 
over  the  existing  transport  protocol.  Although  RTP  was  initially  devised  for  application 
in  audio  and  video  conferences,  this  protocol  can  be  applied  to  convey  other  types  of 
streamed  media  across  the  network. 
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IV.  JAVA  MEDIA  FRAMEWORK  (JMF) 

A.  INTRODUCTION 

This  chapter  provides  an  overview  of  the  Java  Media  Framework  (JMF)  basic 
architecture  and  the  specialized  set  of  classes  to  manage  RTP  transmission,  reception  and 
control.  Several  Unified  Modeling  Language  (UML)  (Booch,  et  al,  97). 
diagrams  are  used  to  illustrate  JMF  classes  interdependencies  and  behavior.  The 
software  application  Rational  Rose  98i  (Rational,  99)  was  used  to  import  the  class 
components  from  the  JMF  API  and  to  draw  these  diagrams.  Appendix  A  contains  a 
description  of  how  UML  diagrams  can  be  prepared  using  the  software  Rational  Rose  98i. 

B.  OVERVIEW 

Java  Media  Framework  (JMF)  is  a  Java  Application  Programming  Interface  (API) 
developed  by  Sun  Microsystems  in  partnership  with  other  companies  to  allow  Java 
programs  deal  with  time-based  media,  especially  audio  and  video  (Sun,  99).  Time-based 
media  can  be  defined  as  any  data  that  changes  meaningfully  with  respect  to  time.  It  is 
also  referred  to  as  streaming  media,  since  it  is  delivered  in  a  steady  stream  of  packets  that 
must  be  received  and  processed  within  a  particular  timeframe  to  produce  acceptable 
results. 

JMF  1.0,  the  1998  version,  supports  playback  of  several  media  types  and  RTP 
stream  reception.  JMF  2.0  is  being  developed  by  Sun  and  IBM,  and  is  currently  in  public 
beta  testing.  JMF  2.0  provides  media  capture  functionality,  file  saving  and  transmission 
of  RTP  streams,  together  defining  a  plug-in  API  that  is  intended  to  enable  developers  to 
customize  and  extend  JMF  functionality.  JMF  2.0  early  access  version  was  released  in 
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June  1999.  The  beta  version  was  released  in  August  1999  and  the  final  release  is  being 
expected  in  Fall  99.  This  chapter  was  written  based  on  JMF2.0  early  access  (Sun,  99), 
and  the  software  development  was  performed  using  JMF  1 .0,  2.0  early  access  and  2.0 
beta. 

C.        JMF  ARCHITECTURE 

The  JMF  API  can  be  divided  into  two  parts.  A  higher-level  API,  called  the  JMF 
Presentation  and  Processing  API,  manages  the  capturing,  processing  and  presentation  of 
time-based  media.  A  low-level  API,  called  the  JMF  Plug-in  API,  allows  customization 
and  extension.  Developers  working  on  new  capabilities  are  expected  to  add  software 
elements  to  the  JMF  Plug-in  API,  thereby  extending  JMF  functionality  and  supporting 
new  media  types. 

JMF  2.0  uses  the  following  basic  classes/interfaces  to  model  the  high-level  API: 

•  MediaLocator  -  describes  the  location  of  a  media  content.  A  MediaLocator  is 
closely  related  to  an  URL,  but  identifies  stream  parameters. 

•  DataSource  -  represents  the  media  itself.  A  DataSource  encapsulates  the 
media  stream  much  like  videotape  does  for  a  video  movie.  This  class  is 
created  based  on  a  Media  Locator. 

•  Player  -  provides  processing  and  control  mechanisms  over  a  DataSource  just 
like  a  VCR  does  for  a  videotape.  A  Player  can  also  render  the  media  to  the 
appropriate  output  device  (e.g.  monitor  or  speakers). 

•  Processor  -  is  a  specialized  type  of  Player  that  provides  control  over  what 
processing  is  done  on  the  input  media  stream.  Processor  supports  a 
programmatic  interface  to  control  the  processing  of  the  media  data,  and  also 
provides  access  to  the  output  data  streams. 

•  DataSink  -  represents  an  output  device  other  than  a  monitor  and  speaker,  the 
most  common  destinations  for  media  output.  For  example,  a  DataSink  can  be 
used  to  save  the  media  to  a  file  or  to  retransmit  to  a  network. 
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•     Manager  -  handles  the  construction  of  Player,  Processor,  DataSource  and 
DataSink  objects. 

Figure  4. 1  shows  some  possible  connections  between  the  above  elements.  Part  a) 
is  the  configuration  used  to  play  a  media  stream.  In  part  b)  we  see  a  processor  creating  a 
DataSource  object  from  another  DataSource.  In  part  c)  a  DataSource  is  passed  to  a 
DataSink  that  writes  it  to  a  file.  Note  that  multiple  DataSource  objects  can  be  connected 
via  Processors. 

A  Player  or  Processor  generally  provides  two  standard  user  interface  components: 
a  visual  component  and  a  control-panel  component.  These  components  can  be  accessed 
by  calling  the  getVisualComponent  and  getControlPanelComponent  methods. 

A  DataSource  represents  a  media  stream  which  can  have  multiple  channels  of 
data  called  tracks.  For  example,  a  Quicktime  (Apple,  99)  file  might  contain  both  audio 
and  video  tracks.  Demultiplexing  is  the  process  of  separating  out  the  individual  tracks  of 
a  complex  stream. 

Inside  a  Player  or  Processor  several  operations  can  take  place.  For  each  operation 
there  is  a  dedicated  piece  of  software  called  a  "plug-in."  There  are  five  types  of  plug-ins: 


• 


• 


Demultiplexers  -  extract  individual  tracks  of  media  from  a  multiplexed  media 
stream. 

Multiplexers  -join  individual  tracks  into  a  single  stream  of  data. 

Codecs  -  perform  media  data  encoding  and  decoding. 

Effect  filters  -  modify  the  track  data  in  some  way,  often  creating  some  special 
effect.  They  can  be  classified  as  post-processing  or  pre-processing  effect 
filters,  depending  on  when  they  are  applied  in  relation  to  the  codec  plug-in. 

Renderers  -  delivers  the  media  data  in  a  track  to  presentation  device.  For 
video,  the  presentation  device  is  typically  the  computer  screen.  For  audio,  the 
presentation  device  is  typically  an  audio  card. 
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Figure  4. 1  JMF  High-level  API  Connection  Examples. 


Figure  4.2  shows  an  example  of  a  Processor  internal  operation.  In  this  example 
the  media  has  one  audio  and  one  video  track  that  are  demultiplexed  and  processed 
individually.  At  the  end  they  are  multiplexed  again  and  become  available  as  another 
DataSource. 

Manager  provides  access  to  a  protocol-independent  and  media-independent 
mechanism  for  constructing  and  connecting  DataSources,  Players,  Processors  and 
DataSinks.  A  DataSource  can  be  created  by  the  method  createDataSouce,  with  a 
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parameter  specifying  either  a  MediaLocator  or  URL.  A  Player  or  Processor  can  be 
created  by  the  method  createPlayer  or  createProcessor.  The  argument  may  be  a 
DataSource,  a  MediaLocator  or  a  URL.  In  order  to  create  a  Player  or  Processor  from  a 
MediaLocator  or  URL,  the  Manager  first  tries  to  create  a  DataSource.  At  last,  for  creating 
a  DataSink  a  Manager  has  to  receive  a  DataSource  and  a  MediaLocator  as  argument.  The 
DataSource  represents  the  input  to  the  DataSink  and  the  MediaLocator  describe  the 
destination  of  the  media  to  be  handled  by  the  DataSink. 


DataSource 


Track  1 


DataSource 


Processor 


Figure  4.2  Processor  Decomposition  (Sun,  99). 

The  JMF  class  hierarchy  can  be  extended  by  implementing  new  plug-in  interfaces 
to  perform  custom  processing  on  a  track,  or  by  implementing  new  DataSources,  Players, 
Processors  or  DataSinks.  New  plug-ins  must  be  registered  with  the  class  PluglnManager. 
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New  Players,  Processors,  DataSources  and  DataSinks  must  be  registered  with  the  class 
PackageManager. 

D.         RTP  SESSION  MANAGER  API 

The  RTP  Session  Manager  API  is  the  part  of  JMF  API  that  deals  with  RTP/RTCP 
transmission  and  reception.  It  is  contained  in  two  packages:  j  avax  .media .  rtp  and 
javax. media. rtp. session. 

The  RTPSessionManager  interface  is  responsible  for  entering  mandatory 
conventions  for  creating,  maintaining  and  closing  an  RTP  session.  It  detects  incoming 
RTP  streams,  maintains  a  list  of  RTP  participants  and  transmits  outgoing  streams.  It  also 
keeps  track  of  global  statistics  about  the  session. 

Since  javax. media,  rtp.  session. RTPSessionManager  is  an  interface,  an 
implementation  is  provided  by  Sun  in  the  file  jmf.jar.  The  class  name  is  RTPSessionMgr. 
There  is  currently  no  source  code  available  for  this  package.  The  following  line  creates 
an  RTPSessionManager: 

RTPSessionManager  mgr   =   new   com. sun. media . RTP. RTPSessionMgr () ; 

1.  RTP  Streams 

RTPStream  is  an  interface  that  represents  a  series  of  data  packets  originated  from 
a  single  host.  There  are  two  sub-interfaces  of  RTPStream:  RTPRecvStream  and 
RTPSendStream.  The  first  represents  a  stream  that  is  being  received  from  a  remote 
participant.  RTPSessionManager  creates  RTPRecvStream  objects  automatically  when 
new  receiving  streams  are  detected.  The  second  represents  a  stream  being  sent  by  a  local 
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participant.  RTPSessionManager  creates  new  RTPSendStream  objects  when  the  method 
createSendStream  is  called,  using  a  DataSource  object  as  argument. 

2.  RTP  Participants 

RTPParticipant  is  an  interface  that  represents  one  participant  in  an  RTP  session.  A 
participant  may  be  the  source  of  zero  or  more  streams.  The  method  getStreams  returns  a 
vector  containing  all  RTPStream  objects  owned  by  the  participant. 

RTPParticipant  has  two  sub-interfaces:  RTPRemoteParticipant  and 
RTPLocalParticipant.  These  are  only  marker  interfaces,  with  no  extra  functionality.  The 
RTPSessionManager  creates  a  new  RTPRemoteParticipant  whenever  a  new  RTCP  packet 
arrives  that  contains  a  CNAME  that  has  not  been  seen  before.  The  association  between 
the  RTPParticipant  object  and  a  RTPRecvStream  is  done  using  the  SSRC  identifier.  It  is 
possible  to  have  an  unassociated  RTPRecvStream  as  the  source  can  start  sending  RTP 
packets  before  a  CNAME  RTCP  packet  is  sent. 

A  participant  that  sends  no  data  is  called  a  Passive  Participant.  Otherwise  it  is 
called  an  Active  Participant.  The  method  getAHParticipants  of  RTPSessionManager 
returns  a  vector  with  all  RTPParticipants.  Similar  methods  exist  to  return  vectors  with 
remote,  local,  active  and  passive  participants. 

3.  RTCP  Source  Description 

RTCPSourceDescription  is  a  class  that  contains  one  description  information 
related  to  a  participant,  as  received  by  the  RTCP  SDES  packets.  So,  associated  with  a 
RTPParticipant  object  there  may  be  several  RTCPSourceDescription  objects,  each 
representing  one  description  information,  as  CNAME,  name,  e-mail,  location,  tool,  etc. 
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The  method  getSourceDescription  of  RTPParticipant  returns  a  vector  with  the 
RTCPSourceDescription  objects  related  to  the  participant. 

4.  RTCP  Report 

Passive  participants  send  RTCP  RR  packets  as  a  feedback  about  the  reception  of 
incoming  streams.  Active  participants  send  RTCP  SR  packets  that  give  information  about 
the  stream  being  sent  and  also  include  feedback  about  the  reception  of  incoming  streams. 
So,  a  SR  packet  includes  the  RR  packet  information.  A  RTCP  SR  or  RR  packet  is 
originated  from  each  SSRC  identifier.  A  participant  may  have  more  than  one  SSRC 
identifier  if  it  is  source  of  more  than  one  stream  in  the  same  session.  Each  SSRC  is 
related  to  one  stream.  In  spite  of  it,  each  participant  has  only  one  CNAME.  RTCP  SDES 
packets  allow  the  correlation  between  SSRC  and  CNAME. 

In  JMF  there  is  an  interface  called  RTCPReport  to  represent  both  RTCP  SR  and 
RTCP  RR  packets.  RTCPReport  has  two  sub-interfaces:  RTCPSenderReport  and 
RTCPReceiverReport.  RTCPReceiverReport  is  a  marker  interface.  All  of  its  functionality 
is  contained  in  RTCPReport.  RTCPSenderReport  extends  RTPCReport  to  provide 
methods  for  retrieve  sender  report  information.  The  method  getReports  of 
RTCPParticipant  returns  a  vector  containing  the  last  SR  or  RR  reports  sent  by  the 
participant.  This  method  will  usually  return  only  one  report:  SR  if  the  participant  is  active 
and  it  sends  only  one  stream,  and  RR  if  the  participant  is  passive.  If  the  participant  sends 
more  than  one  stream  this  method  will  return  the  same  number  of  SR  reports,  because 
each  SR  report  is  associated  to  one  stream/SSRC. 

RTCPReport  has  a  method  called  getFeedback  that  returns  a  vector  of 
RTCPFeedback  objects.  Each  RTCPFeedback  object  conveys  information  about  the 
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reception  of  one  incoming  stream.  In  other  words,  it  represents  a  feedback  from  a  SSRC 
about  other  SSRC  that  originates  a  stream.  Feedback  information  includes  fraction  lost, 
cumulative  number  of  packets  lost,  etc. 

Figure  4.3  contains  a  class  diagram  describing  the  relationship  between 
RTPParticipant  and  other  classes/interfaces  discussed  so  far.  This  class  diagram  uses  the 
standard  notation  specified  for  the  Unified  Modeling  Language  (UML)  (Booch,  et  al,  97). 
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Figure  4.3  RTPParticipant  Class  Diagram. 
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5.  Event  Listeners 

The  RTP  API  has  four  types  of  event  listeners:  RTPSessionListener, 
RTPSendStreamListener,  RTPReceiveStreamListener  and  RTPRemoteListener.  These 
listeners  provide  a  mechanism  of  event  notification  on  the  state  of  the  RTP  session  and  its 
streams. 

The  RTPSessionListener  interface  detects  events  related  to  the  RTP  session  as  a 
whole  rather  than  a  particular  stream  or  participant.  Two  types  of  events  can  be  posted: 
NewparticipantEvent,  generated  when  a  RTCP  packet  from  an  unknown  participant  was 
received,  and  LocalCollisionEvent,  generated  when  a  SSRC  collision  was  detected 
between  the  local  participant  and  a  remote  one. 

The  RTPSendStreamListener  interface  detects  state  transitions  that  occur  on  a 
RTPSendStream.  Four  types  of  events  can  be  posted: 

•  NewSendStreamEvent  -  generated  when  a  new  transmitting  stream  has  been 
created. 

•  ActiveSendStreamEvent  -  generated  when  the  transfer  of  data  from  the 
DataSource  object  has  started  arriving  after  a  previous  stop. 

•  InactiveSendStreamEvent  -  generated  when  the  transfer  of  data  from  the 
DataSource  object  has  stopped. 

•  SendPay loadChangeEvent  -  generated  when  the  payload  type  of  the 
DataSource  object  has  changed. 

The  RTPRecvStreamListener  interface  detects  state  transitions  that  occur  on  a 

RTPRecvStream.  Seven  types  of  events  can  be  posted: 

•  NewRecvStreamEvent  -  generated  when  a  new  incoming  stream  has  been 
detected.  This  means  that  RTP  data  packets  has  been  received  from  a  SSRC 
that  had  not  previously  been  sending  data. 
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•  ActiveRecvStreamEvent  -  generated  when  the  stream  data  packets  have 
started  arriving  after  a  previous  stop. 

•  InactiveSendStreamEvent  -  generated  when  the  stream  data  packets  have 
stopped  arriving. 

•  PayloadChangeEvent  -  generated  when  a  remote  sender  has  changed  the 
payload  type  of  a  data  stream. 

•  TimeOutEvent  -  generated  when  a  remote  sender  has  not  sent  packets  for  a 
while  and  can  be  considered  timed-out.  A  time-out  has  the  same  effect  as  if 
the  participant  has  sent  the  RTCP  BYE  packet. 

•  RecvStreamMappedEvent  -  generated  when  a  recently  created  stream  has 
been  associated  with  a  participant  after  the  first  RTCP  packet  has  been 
received. 

•  AppEvent  -  generated  when  an  RTCP  APP  packet  has  been  received. 
The  RTPRemoteListener  interface  detects  events  related  to  RTCP  control 

messages  received  from  remote  participants.  This  interface  can  be  used  for  monitoring 
applications  that  do  not  need  to  receive  each  stream,  but  only  RTCP  reports.  Three  types 
of  events  can  be  posted: 

•  RecvReceiverReportEvent  -  generated  when  a  new  RTCP  RR  report  has  been 
received. 

•  RecvSenderReportEvent  -  generated  when  a  new  RTCP  SR  report  has  been 
received. 

•  RemoteCollisionEvent  -  generate  when  two  remote  participants  are  using  the 
same  SSRC  simultaneously.  Upon  detecting  the  collision,  both  remote 
participants  should  start  sending  data  with  new  SSRCs. 

6.  RTP  Media  Locator  and  RTP  Session  Address 

RTPMediaLocator  is  a  class  that  stores  information  about  the  session  address  and 
other  settings  used  in  a  session  like  TTL  and  SSRC.  The  format  is  similar  to  an  URL. 
The  RTP  MediaLocator  string  is  of  the  form: 

rtp://address:port[:SSRC]/content-type/[TTL] 
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Optional  parameters  are  enclosed  in  brackets.  Address  is  the  IP  address  of  the 
session.  Port  is  the  port  number  used  for  RTP  packets.  It  must  be  an  even  number 
according  RFC  1889.  SSRC  is  optional.  Content-type  can  be  either  "audio"  or  "video." 
TTL  is  the  time-to-live,  also  optional.  The  string  above  is  used  to  create  a 
RTPMediaLocator  object.  If  the  media  locator  is  invalid  a  MalformedRTPMRLException 
will  be  thrown. 

The  class  RTPMediaLocator  has  several  methods  to  retrieve  the  above 
information  about  a  session.  For  example,  the  method  getSessionAddress  returns  a  string 
with  the  IP  address  and  the  method  getSessionPort  returns  an  integer  with  the  RTP  port 
number.  However,  to  create  a  session  and  instantiate  a  RTPSessionManager  under  JMF, 
another  object  has  to  be  created  first:  an  RTPSessionAddress. 

RTPSessionAddress  is  a  class  that  encapsulates  a  pair  of  multicast  addresses,  each 
constituting  of  an  IP  address  and  a  port  number.  One  multicast  address  is  used  by  RTP 
and  the  other  by  RTCP.  (In  fact,  this  definition  of  a  RTPSessionAddress  is  too  broad, 
because  RFC  1 889  says  that  the  RTCP  multicast  address  must  have  the  same  IP  address 
and  a  immediately  higher  port  with  relation  the  RTP  address.)  Also,  RTP  port  must  be 
even  by  RFC  1889. 

In  order  to  create  a  RTPSessionAddress  object  for  representing  a  session  address, 
two  InetAddress  objects  are  required  as  arguments,  one  for  RTP  and  other  for  RTCP.  The 
InetAddress  class  is  part  ofthejava.net  package  and  encapsulates  an  IP  address.  The 
static  method  getByName  can  create  a  InetAddress  object  given  a  string  with  the  IP 
address.  Figure  4.4  contains  a  sequence  diagram  that  describes  the  creation  of  a 
RTPSessionAddress  object. 
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destaddr  =  getByName(address) 


*D 


sessaddr  =  create(  destaddr,  port,  destaddr,  port  +  1) 


RTPSession 
Address 


Figure  4.4  RTPSessionAddress  Creation  UML  Sequence  Diagram. 

7.         RTP  Session  Manager 

After  creating  an  empty  RTPSessionManager  object  as  described  in  item  C),  a 
RTPSessionManager  must  be  initialized  by  calling  the  method  initSession.  The  required 
parameters  are: 

•  The  local  IP  address  as  a  RTPSessionAddress  object.  This  object  can  be 
created  by  calling  the  RTPSessionAddress  constructor  with  no  arguments. 

•  An  array  of  RTPSourceDescription  objects  containing  information  about  the 
local  participant. 

•  The  fraction  of  the  bandwidth  to  be  allocated  to  RTCP.  RFC  1 889 
recommends  5%  of  the  RTP  bandwidth. 
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•     The  fraction  of  the  RTCP  bandwidth  to  be  allocated  to  Sender  Reports. 
RFC  1889  recommends  25%  of  the  RTCP  bandwidth. 

At  this  moment  the  RTPSessionManager  is  still  not  active.  The  method 

startSession  must  be  called  in  order  to  cause  RTCP  reports  be  generated  and  callbacks  to 

the  several  listeners  to  be  made.  This  method  must  be  called  prior  to  the  creation  of  any 

streams  on  a  session.  The  required  parameters  are: 

•  The  session  address  as  a  RTPSessionAddress  object. 

•  The  time-to-live  (TTL) 

•  A  RTPEncryptionlnfo  object  if  any  encryption  is  desired. 

8.  Receiving  and  Presenting  RTP  Media  Streams 

After  RTPSessionManager  has  been  started,  any  receiving  stream  will 
generate  a  RTPRecvStream  object  and  a  NewRecvStreamEvent  event.  In  the  update 
method  of  the  interface  RTPRecvStreamListener,  the  RTPRecvStream  object  can  be 
obtained  by  the  method  getRecvStream  of  NewRecvStreamEvent.  By  retrieving  the 
DataSource  from  the  RTPRecvStream  object  and  passing  it  to  the  Manager  we  can  create 
a  Player  for  the  received  stream.  The  class  PlayerWindow,  supplied  by  Sun,  receives  a 
Player,  plays  back  the  media,  audio  or  video,  and  creates  a  control  window.  Figure  4.5 
contains  a  collaboration  diagram  describing  the  sequence  above.  This  collaboration 
diagram  uses  standard  notation  for  showing  logical  relationship  between  instantiated 
objects,  as  specified  by  UML  (Booch,  et  al,  97). 
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Figure  4.5  RTP  Media  Presentation  Collaboration  Diagram.  Numbered 
arrows  indicate  the  sequence  of  method  calls  occurring  between  objects. 

9.  Transmitting  RTP  Streams 

RTP  stream  can  be  transmitted  by  passing  a  DataSource  object  to  the  Session 
Manager  using  the  method  createSendStream.  As  a  DataSource  can  contain  multiple 
streams/tracks,  an  index  of  the  stream  must  be  specified.  The  DataSource  is  usually 
obtained  as  an  output  of  a  Processor.  In  this  case  the  Processor  has  to  generate  RTP- 
encoded  data  because  the  Session  Manager  does  not  perform  that  function.  So  each  track 
to  be  transmitted  has  to  be  set  to  an  RTP-specific  format.  The  method  setFormat  of  the 
TrackControl  interface  allows  a  Processor  to  set  the  format  of  a  track.  If  the  format  can 
not  be  applied  to  the  track,  an  IncompatibleFormatException  is  thrown. 
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If  the  physical  source  of  the  stream  is  intended  to  be  camera  or  microphone,  a 
CaptureDevicelnfo  object  must  be  created  by  using  the  method  getDevice  of 
CaptureDeviceManager.  The  argument  passed  to  the  method  getDevice  is  a  Format 
object,  which  describes  a  media  format.  The  CaptureDeviceManager  searches  for  a 
device  in  the  system  that  supports  the  desired  format.  The  method  getLocator  of 
CaptureDevicelnfo  returns  a  Media  Locator  that  can  be  used  to  create  a  Processor. 

Figure  4.6  contains  a  UML  collaboration  diagram  that  describes  a  JMF  procedure 
to  capture  the  media  and  transmit  it  in  a  RTP  session. 
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Figure  4.6  Media  Capture  and  Transmission  Collaboration  Diagram. 
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10.        RTP  Statistics 


JMF  maintains  several  statistics  about  the  RTP  session  and  its  streams.  Statistics 


about  the  session  as  a  whole  are  obtained  through  the  RTPSessionManager  by  the 
methods  getGlobalTransmissionStats  and  getGlobalReceptionStats.  These  methods 
retrieve  GlobalReceptionStats  and  Global TransmissionStats  objects  respectively,  which 
have  methods  to  get  each  statistic.  Individual  stream  statistics  are  maintained  within 
RTPSendStream  and  RTPRecvStream  objects  by  the  RTPTransmissionStats  and 
RTPReceptionStats  interfaces.  Figure  4.7  contains  a  UML  class  diagram  showing  the 
classes  mentioned  above. 
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Figure  4.7  RTP  Statistics  Class  Diagram. 
53 


D.         SUMMARY 

The  Java  Media  Framework  (JMF)  architecture  is  intended  to  support  multimedia 
in  a  variety  of  applications.  It  is  based  in  a  high  level  API,  containing  generic  classes  to 
capture  and  present  media,  and  a  low-level  API  to  allow  customization  and  extension. 
The  RTP  API  supports  RTP  transmission  and  reception,  as  well  as  retrieval  of  RTP 
statistics.  Future  work  on  JMF  can  include  the  transmission  of  time-based  media  other 
than  audio  and  video,  such  as  the  Distributed  Interactive  Simulation  (DIS)  protocol  and 
other  behavior-based  streams. 


54 


V.  DESIGN  AND  IMPLEMENTATION  OF  THE 
RTPMONITOR  APPLICATION 

A.  INTRODUCTION 

This  chapter  covers  the  functionality  and  class  design  of  the  program  developed 
as  the  main  goal  of  this  thesis,  called  rtpMonitor.  rtpMonitor  is  a  Java  application  that 
presents  and  records  RTP  statistics  about  a  single  RTP  session.  It  can  also  present  the 
media  being  received,  either  audio  or  video,  by  launching  audio/video  playback  windows. 
All  Unified  Modeling  Language  (UML)  diagrams  in  this  chapter  conform  to  the  UML 
Specification  (Booch,  97)  and  were  prepared  using  the  Java  to  UML  facilities  of 
Rational  Rose  98i  (Rational,  99). 

B.  RTPMONITOR  FUNCTIONALITY  AND  INTERFACE 

This  section  contains  a  summary  of  the  rtpMonitor  functionality.  Additional 
information  can  be  found  in  the  Appendix  B,  the  rtpMonitor  User  Manual. 

1.  Graphical  User  Interface  (GUI) 

Figure  5.1  shows  the  rtpMonitor  main  window.  In  the  "Bookmark"  menu,  the  user 
can  select,  add  or  delete  a  bookmark  related  to  the  session  name/address.  In  the 
"Preferences"  menu  the  user  can  select  whether  the  monitor  will  participate  in  the 
session,  play  streams  and/or  record  statistics.  The  user  can  also  be  selected  the  duration  of 
the  monitoring  session,  the  recording  interval  and  the  presentation  interval.  In  the 
"Output  files"  menu  the  user  can  launch  an  external  viewer  to  see  the  contents  of  the 
statistic  files  generated  by  the  program. 
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The  upper  part  of  the  window  contains  the  session  address,  according  the 
RtpMediaLocator  format  and  the  session  name.  The  user  enters  the  session  name  when  a 
new  bookmark  is  inserted.  This  name  does  not  necessarily  have  any  relation  with  the 
session  name  of  the  Session  Description  Protocol  (SDP)  announcements.  The  rest  of  the 
window  contains  the  current  RTP  statistics. 
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Figure  5.1  rtpMonitor  Main  Window. 

2.  Statistics  Display 

The  program  periodically  displays  the  following  information: 

•  Global  statistics:  general  reception  information  about  the  whole  session. 

•  Stream  statistics:  about  the  reception  of  a  single  stream. 
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•     Feedback:  the  RTCP  Receiver  Report  information  from  all  participants  about 
the  stream  being  monitored. 


3.  Statistics  Recording 

rtpMonitor  can  record  statistics  in  text  files  using  a  recording  interval  defined  by 
the  user.  Several  files  are  created  and  managed  to  simplify  further  retrieval.  There  are 
files  to  hold  data  from  the  last  five  minutes,  previous  five  minutes,  last  hour,  previous 
hour  and  different  dates.  Multiple  file  sizes  and  periodicities  are  employed  to  avoid 
excessive  file  sizes  when  performing  extended  monitoring.  File  name  conventions  are 
presented  in  Appendix  A. 

4.  Media  Presentation 

rtpMonitor  can  present  the  incoming  video  stream  on  the  computer  screen  or  the 
incoming  audio  streams  on  the  computer  speakers.  This  option  is  selected  in  the 
"Preferences"  menu.  In  case  of  video,  each  stream  is  presented  in  a  separate  window.  In 
case  of  audio,  a  toolbar  window  is  opened  to  allow  audio  controls  (such  as  the  mute 
function).  The  launched  applications  are  part  of  the  JMF  API. 

5.  Command  Line  Operation 

If  the  program  is  called  with  any  argument  in  the  command  line  the  GUI  will  not 
be  launched.  In  this  case  the  session  address  and  preferences  must  be  passed  by  the 
command  line. 
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The  following  command  line  is  an  example  of  invocation  of  the  rtpMonitor  to 
record  statistical  data  and  present  RTP  session  streams  during  a  period  of  24  hours: 

Java    org . web3d . vrtp . rtp . RtpMonitor      rtp: //224 . 120 . 67. 46/64542/12 
-play   -record   -e  24 

Using  the  command  line  version  of  rtpMonitor  no  statistics  are  sent  to  the 
console.  A  monitoring  session  can  be  stopped  by  pressing  "Crtl-C". 

C.        RTPMONITOR  CLASS  DESIGN 

The  rtpMonitor  class  design  goal  was  to  create  a  set  of  basic  classes  that  could 
perform  the  RTP  monitoring  tasks  with  minimal  access  from  user  applications  to  the  Java 
Media  Framework  API.  Figure  5.2  contains  a  data  flow  diagram  showing  the  exchange  of 
data  (statistics,  settings  and  commands)  between  classes  in  rtpMonitor.  Each  bubble  in 
the  diagram  will  be  discussed  in  the  remainder  of  this  session.  Appendix  C  contains  the 
rtpMonitor  Javadoc,  and  Appendix  D  contains  the  rtpMonitor  source  code. 

1.  RtpMonitorManager  and  RtpUtil 

The  RtpMonitorManager  class  is  the  main  interface  between  a  user  application 

and  JMF.  It  performs  the  following  functions: 

.     Creates  and  starts  a  session,  represented  by  a  RTPSessionManager  object  in 
JMF. 

•     Records  session  statistics  in  files. 

,     Presents  ( i.e.  plays)  incoming  media  streams. 
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RtpMonitor 
GUI 


Audio  or  Video 


Figure  5.2  RTPMonitor  Data  Flow  Diagram. 


RtpMonitorManager  does  not  have  methods  to  retrieve  each  single  statistic  in  an 
RTP  session.  If  an  application  needs  access  to  individual  statistics,  e.g.  for  display 
purposes,  it  is  necessary  to  retrieve  the  RTPSessionManager  object  and  use  its  methods  to 
get  the  desired  set  of  statistics. 
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The      following     parameters     are     necessary     for     instantiating     a     new 
RtpMonitorManager  object: 

•  The  session  address  string,  e.g.  rtp://224.2. 134.67:50980/1 27 

•  A  Boolean  variable  indicating  if  the  statistics  are  to  be  recorded  on  files. 

•  A  Boolean  variable  indicating  if  the  incoming  streams  are  to  be  played. 

•  A  Boolean  variable  indicating  if  the  monitor  will  actively  participate  in  the 
session  (i.e.,  send  RTCP  packets). 

During  instantiation,  RtpMonitorManager  creates  a  RTPSessionManager  object  in 
JMF.  Figure  5.3  shows  a  UML  sequence  diagram  representing  the  steps  taken  by 
RtpMonitorManager  in  creating  and  initializing  the  session  manager.  Figure  5.4  shows  a 
class  diagram  of  the  classes  related  to  RtpMonitorManager. 

RtpUtil  is  a  class  that  has  only  static  methods  for  performing  some  extra 
functionality  to  JMF.  For  example,  there  is  a  method  to  return  the  username  given  a 
RTPParticipant  object. 

2.  RecordTask  and  FileCatalog 

RecordTask  is  a  class  used  by  RtpMonitorManager  objects  to  write  the  statistics 
periodically  to  disk.  It  is  created  as  a  separate  thread  that  waits  for  a  fixed  period  of  time 
after  writing  data  to  disk.  This  class  writes  data  to  the  file  called 
"statisticsLastReport .  txt"  that  contains  the  last  single  report  only.  The 
FileCatalog  class  is  actually  responsible  for  transferring  data  to  other  files  as  well  (last 
five  minutes,  last  hour,  and  so  on). 
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*b 
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Figure  5.3  RTPSessionManager  Initialization  UML  Sequence  Diagram. 


3.  RtpPlayerWindow 

RtpPlayerWindow  is  a  class  used  to  create  a  window  for  playing  an  audio/video 
stream.  It  is  a  subclass  of  PlayerWindow,  adding  the  capacity  of  modifying  the  window 
name.  Both  classes  were  developed  by  Sun.  RtpPlayerWindow  came  with  JMF1.1 
sample  code  and  PlayerWindow  is  in  the  file  jmf .  j  ar. 
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Figure  5.4  RTPMonitorManager  UML  Class  Diagram. 
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4.  RtpMonitor 

The  main  RtpMonitor  class  extends  a  Frame  and  implements  the  rtpMonitor 
Graphical  User  Interface  (GUI).  RtpMonitor  and  RtpMonitorCommandLine  can  be 
considered  classes  in  the  application  level.  They  use  the  services  of  RtpMonitorManager 
to  provide  some  user  level  functionality.  RtpMonitor  has  the  following  functions: 

•  Collects  user  preferences.  It  uses  the  ModifyPreference  class  as  the  dialog 
box. 

•  Selects,  adds  and  deletes  bookmarks.  It  uses  the  SelectBookmark, 
AddBookmark  and  DeleteBookmark  classes  as  dialog  boxes. 

•  Displays  statistics  periodically.  It  creates  a  Display  Task  object,  which  is  a 
new  thread  that  sleeps  for  a  user-defined  time,  to  call  its  methods  for  updating 
the  statistics  on  screen. 

5.  RtpMonitor  Applet 

A  good  idea  might  be  to  make  an  applet  version  in  a  web  page.  To  do  this, 
security  problems  must  be  addressed,  as  the  monitor  must  write  data  to  disk  and  open 
network  connections.  The  implementation  of  an  RTP  Monitor  version  running  as  an 
applet  was  left  as  future  work. 

6.  RtpMonitorCommandLine 

RtpMonitorCommandLine  objects  are  instantiated  by  the  main  method  of 
RtpMonitor  when  some  parameter  is  passed.  This  class  performs  the  creation  of  a 
RTPSessionManager  object  but  does  not  present  statistics  on  screen. 

Several  options  can  be  passed  by  the  command  line  call  to  RtpMonitor.  They  are 
basically  the  same  available  in  RtpMonitor  preferences  dialog. 
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D.         SUMMARY 

The  rtpMonitor  application  allows  the  monitoring  of  an  RTP  session  by 
presenting  session  and  stream  statistics  on  screen  as  well  as  recording  statistics  on  files 
for  future  analysis.  The  program  also  supports  Media  presentation  of  audio  and  video. 

The  design  goal  of  the  rtpMonitor  was  to  provide  a  basic  set  of  classes  for  RTP 
statistics  recording  with  minimal  interfacing  with  JMF. 
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VI.    RTP  MANAGEMENT  INFORMATION  BASE  (MIB) 

A.  INTRODUCTION 

The  RTP  Management  Information  Base  (MIB)  defines  Simple  Network 
Management  Protocol  (SMNP)  objects  for  managing  RTP  systems.  This  work  is 
produced  by  the  Audio  Video  Transport  (AVT)  Group  of  the  Internet  Engineering  Task 
Force  (IETF)  (Baugher,  et  al.,  99)  as  broad  guidance  for  all  applications  collecting  RTP 
statistics.  This  chapter  describes  some  basic  concepts  of  the  RTP  MIB  and  compares  its 
attributes  with  the  existing  set  of  Java  Media  Framework  used  by  the  rtpMonitor 
application. 

B.  NETWORK  MANAGEMENT  OVERVIEW 

A  network  management  system  is  a  collection  of  tools  for  networking  monitoring 
and  control,  including  hardware  and  software  (Stallings,  97).  The  key  elements  of  a 
network  management  system  are: 

•  Management  station  -  the  interface  to  the  network  manager. 

•  Agent  -  responds  to  requests  for  information  and  for  taking  actions.  Typically, 
the  agent  software  is  installed  in  routers,  bridges,  hubs  and  hosts. 

•  Management  information  base  (MIB)  -  represents  a  collection  of  objects  (data 
variables)  managed  by  agents. 

•  Network  management  protocol  -  links  the  management  station  with  the 
agents. 

The  Simple  Network  Management  Protocol  (SNMP)  is  the  most  widely 

management  protocol  in  use  for  TCP/IP  networks.  SNMPv2  (version  2)  is  described  in 
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RFC  1901  (Case,  et  al.,  96).  SMNP  include  mechanisms  for  retrieving  data  from  agents, 
set  values  of  objects  on  agents,  and  notify  the  management  station  of  significant  events. 

C.  RTP  MIB  DESCRIPTION 

RTP  agents  running  this  MIB  can  be  either  RTP  hosts  (end  systems)  or  RTP 
Monitors.  The  objective  is  to  collect  statistical  data  about  RTP  sessions  and  its  streams, 
for  diagnostics  and  management  purposes.  Each  agent  maintains  a  MIB  that  can  be 
queried  by  a  Manager.  Only  the  last  updated  statistic  is  stored  in  the  MIB. 

RTP  MIB  has  three  tables: 

•  rtpSession Table  -  contains  objects  that  describe  active  sessions  at  the 
host,  intermediate  system  or  monitor.  There  is  an  entry  in  this  table  for 
each  RTP  session  on  which  packets  are  being  sent,  received  and/or 
monitored. 

•  rtpSenderTable  -  contains  information  about  senders  of  the  RTP  session. 
RTP  sender  hosts  must  have  an  entry  in  this  table  for  each  stream  being 
sent,  but  RTP  receiving  hosts  do  not  have  to  maintain  this  table.  RTP 
Monitors  must  create  an  entry  for  each  observed  stream. 

•  rtpRcvrTable  -  contains  information  about  receivers  of  the  RTP  session. 
RTP  receivers  must  create  an  entry  in  this  table  for  each  received  stream. 
RTP  senders  do  not  have  to  maintain  this  table.  RTP  monitors  must  have 
an  entry  for  each  pair  sender/receiver  in  the  sessions  being  monitored. 

D.  COMPATIBILITY  WITH  JMF  STATISTICS 

Appendix  E  is  a  table  that  compares  the  fields  in  the  RTP  MIB  tables  with  the 
JMF  statistics  used  by  RTPMonitor.  This  comparison  has  two  objectives: 

•  Detect  what  MIB  statistics  are  not  supplied  by  JMF.  If  JMF  does  not  supply 
all  the  required  MIB  data,  an  RTP  MIB  agent  can  not  be  implemented  using 
JMF. 

•  Detect  what  JMF  statistics  are  not  part  of  RTP  MIB.  Some  of  the  JMF 
statistics  can  be  added  to  the  RTP  MIB. 
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The  comparison  was  sent  to  the  JMF  and  IEFT-AVT  mailing  lists.  The  comments 
made  by  Bill  Strahm,  one  of  the  authors  of  the  RTP  MIB  Internet  Draft  are  included  in 
the  table  of  Appendix  E.  Sun  Microsystems  software  engineers  have  not  replied  with  any 
comments. 

E.         SUMMARY 

The  Real-time  Transport  Protocol  (RTP)  Management  Information  Base  (MIB) 
consists  of  a  new  Internet-Draft  proposed  by  the  AVT  group  of  the  IETF  to  be  applied  in 
RTP  network  management  with  SNMP. 

A  number  of  significant  differences  were  found  between  JMF  2.0  (Sun,  99)  and 
the  RTP  MIB  (Baugher,  et  al.,  99).  Further  work  will  need  to  be  performed  by  one  or 
both  organizations  to  resolve  these  discrepancies. 
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VII.    EXPERIMENTAL  RESULTS 

A.  INTRODUCTION 

This  chapter  presents  the  experimental  results  achieved  with  the  rtpMonitor 
application  and  describes  problems  faced  during  the  testing  phase.  Furthermore,  this 
chapter  presents  the  work  on  an  RTP  header  for  the  Distributed  Interactive  Simulation 
(DIS)  protocol  (IEEE,  95). 

B.  TEST  RESULTS 

The  Java  application  rtpMonitor,  described  in  Chapter  V,  was  tested  using  the 
versions  1.1.7,  1.2.1  and  1.2.2  of  the  Java  Development  Kit  (JDK),  in  combination  with 
versions  1.0,  2.0  Early  Access,  and  2.0  Beta  of  the  Java  Media  Framework.  JMF  Beta  has 
three  subversions  available: 

•  Pure  Java:  includes  binaries  written  entirely  in  the  Java  programming 
language  that  can  be  installed  on  any  operating  system  supported  by  the  Java 
platform. 

•  Solaris  Performance  Pack:  an  optimized  version  for  the  Solaris  platform  that 
includes  binaries  for  this  operating  environment. 

•  Windows  Performance  Pack:  an  optimized  version  for  the  Windows  platforms 
that  includes  binaries  for  this  operating  environment. 

rtpMonitor  was  tested  only  in  Windows  NT  platforms  using  the  Windows 

Performance  Pack.  The  program  was  tested  in  all  its  functionality,  with  special  emphasis 

on  the  recording  capabilities.  It  proved  to  be  robust,  running  continuously  for  the 

maximum  allowed  session  duration  (one  week)  several  times.  It  has  generated  correct 

output  files  of  more  than  40  Mbytes  for  a  single  session. 
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C.  OBSERVED  PROBLEMS 

Several  errors  (i.e.  software  bugs)  were  detected  in  JMF  1.0  through  the 
development  of  rtpMonitor.  The  following  errors  were  reported  in  the  JMF  mailing  list 
and  were  corrected  in  JMF2.0  Early  Access: 

•  The  number  of  lost  PDU  in  the  stream  data  was  usually  wrong.  It  returned  a 
high  number  of  lost  PDU,  even  greater  than  the  actual  number  of  packets  sent 
by  the  source. 

•  When  a  non-participating  option  had  been  selected  the  information  about  the 
active  and  passive  participants  was  inconsistent.  Usually  no  participants  were 
presented  even  though  they  might  have  existed. 

•  Individual  video  windows  could  not  be  closed. 

9     After  a  session  had  been  stopped  and  a  new  session  had  been  initiated,  the 
global  statistics  about  the  previous  session  were  still  being  considered. 

In  JMF  2.0  Early  Access  and  JMF  2.0  Beta,  the  only  observed  error  is  related  to 

the  Cumulative  Number  of  Packets  Lost  (Packets  Lost  in  the  Feedback  Area)  which 

returns  wrong  values  after  some  time.  This  problem  has  been  reported  to  Sun's  JMF-bugs 

e-mail  box  (jmf-bugs@sun.com)  and  to  Sun's  JMF-interest  mailing  list 

(jmf-interest@java.sun.com). 

D.  EXTENDING  DIS-JAVA-VRML  PDU  HEADER 

Protocol  Data  Units  (PDU)  currenty  used  by  the  vrtp  protocol  (Brutzman,  99)  are 
based  on  the  Distributed  Interactive  Simulation  (IEEE,  95)  standard.  As  the  vrtp 
protocol  intends  to  use  the  Real-Time  Transport  Protocol  as  the  transport  protocol,  an 
RTP  Header  should  be  added  to  the  existing  DIS  PDU.  Although  such  a  modification  is 
no  longer  strictly  compliant  with  DIS  over-the-wire  formats,  it  nevertheless  provides  and 
interesting  opportunity  for  research  and  testing. 
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As  a  product  of  this  thesis,  a  new  Java  class  for  extending  the  DIS  PDU  with  RTP 
header  information  was  created.  This  class  is  specifically  designed  to  be  part  of  the  DIS 
package  (mn  nps  naVy  ^is)  use<^  by  the  DIS-Java-VRML  application,  a  component 
of  the  vrtp  protocol  (Brutzman,  99).  This  class  was  named  RtpHeader.  Appendix  F 
contains  the  RtpHeader  Javadoc  and  Appendix  G  contains  the  RtpHeader  source  code. 

The  RtpHeader  class  was  briefly  tested  during  the  period  of  this  thesis.  Client 
software  automatically  discriminates  among  DIS  PDUs  with  and  without  RTP  headers. 
This  is  an  excellent  result.  Further  testing  is  required  as  a  future  work. 

E.         SUMMARY 

The  rtpMonitor  application  has  successfully  been  tested  with  different  versions  of 
the  Java  Development  Kit  (JDK)  and  Java  Media  Framework  (JMF).  The  program 
proved  to  be  robust  in  several  long-term  monitoring  sessions.  Despite  most  JMF 
problems  have  been  solved  in  version  2.0  Early  Access,  additional  fix  should  be  done. 

A  new  header  for  the  Protocol  Data  Units  (PDU)  of  the  DIS-Java-VRML 
application  was  developed  and  initial  test  produced  excellent  results. 
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VIII.    CONCLUSIONS  AND  RECOMMENDATIONS 

A.  RESEARCH  CONCLUSIONS 

The  RTP  monitor  application  has  been  successfully  implemented  using  Java 
Media  Framework  (JMF).  The  monitor  can  be  applied  to  help  detect  problems  in  RTP 
based  multicast  session  by  adding  statistics  recording  capabilities,  not  available  in  the 
existing  individual  conference  applications.  The  presentation  of  RTP  statistics  and 
feedback  reports  in  a  single  screen  is  also  a  good  feature  for  on-line  monitoring.  The 
RtpMonitor  class  package  can  be  used  by  future  RTP  applications,  as  a  simple  means  to 
record  statistics  with  no  direct  access  needed  to  JMF  resources.  This  is  an  important  new 
capability,  since  core  Java  classes  do  not  provide  access  to  IGMP  (Deering,  89)  packets 
on  the  network  layer  and  would  otherwise  require  additional  programming  of  native  code 
(e.g.  C  source  code)  via  the  Java  Native  Interface  (JNI)  (Sun,  99)  to  achieve  RTCP 
capabilities. 

B.  RECOMMENDATIONS  FOR  FUTURE  WORK 

A  number  of  excellent  opportunities  for  future  work  are  now  possible. 
1.  Participants  Information 

RTCP  Session  Description  Reports  convey  several  data  about  each  participant,  as 
name,  e-mail  and  tool  being  used.  This  information  can  be  added  to  RTPMonitor  for 
presentation  and  recording  purposes.  JMF  contains  the  necessary  classes  and  methods  to 
set,  send  and  retrieve  this  data. 
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2.  Extensible  Markup  Language  (XML)  Recording 

rtpMonitor  records  the  RTP  session  data  as  text  files.  The  use  of  Extensible 
Markup  Language  (XML)  (Word  Wide  Web  Consortium,  99)  for  recording  the  data 
would  allow  an  easier  data  retrieval.  Java-based  XML  parsers  are  available  and  can 
provide  an  efficient  way  to  read  and  write  Java  data  structures  as  XML  documents  and 
vice-versa. 

3.  Recorded  Data  Analysis  and  Presentation 

A  tool  to  retrieve  remotely  (or  receive)  the  rtpMonitor  output  file  statistics  is 
needed.  It  should  be  able  to  present  the  each  individual  data  in  a  graphical  format, 
covering  a  period  of  time  defined  by  the  user.  Again  XML  provides  browsing  options  for 
automatic  presentation  of  such  data  by  any  web  browser. 

4.  Session  Description  Protocol  (SDP)  Reception 

The  Session  Description  Protocol  (SDP)  is  intended  for  describing  multimedia 
sessions  for  the  purposes  of  session  announcement,  session  invitation,  and  other  forms  of 
multimedia  session  (IETF,  98).  In  rtpMonitor  the  user  has  to  enter  the  RTP  session 
address.  Future  work  needs  to  add  SDP  reception  capability  to  simplify  starting  a 
monitoring  session  and  allowing  the  detection  of  ongoing  sessions,  in  addition  to  the 
current  approach. 

5.  RtpMonitor  Activation  from  SDR 

Session  Directory  (SDR)  is  a  session  directory  tool  designed  to  allow  the 
advertisement  and  joining  of  multicast  conferences  on  the  MBone  (UCL,  99).  It  is 
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possible  to  launch  external  application  from  SDR  by  modifying  some  of  the  SDR 
configuration  files.  Providing  a  plug-in  file  to  SDR  might  result  in  an  easier  activation  of 
the  rtpMonitor  application. 

6.  JMF  Extensibility  for  Other  Media 

Java  Media  Framework  (JMF)  distribution  comes  with  a  set  of  concrete  classes  to 
implement  the  RTP  transmission,  reception  and  playback  of  audio  and  video.  However, 
the  extension  of  JMF  to  support  other  types  of  media  is  highly  desirable.  An  important 
area  of  future  work  is  the  implementation  of  simulation  data  transmission  and  reception 
using  the  RTP  API  of  Java  Media  Framework.  This  work  will  have  direct  application  in 
the  vrtp  streaming  behaviors  stack. 

7.  Automated  Network  Monitoring  of  RTP  Streams  for  VRTP. 

The  rtpMonitor  class  library  can  be  integrated  with  the  vrtp  protocol  to  allow  the 
automatic  monitoring  capability  in  vrtp  sessions.  For  this  purpose  the  rtpMonitor  library 
must  be  updated  to  support  transmission  statistics  and  direct  activation  by  vrtp 
components.  This  is  a  good  area  of  study  for  agent-based  network  monitoring,  diagnosis 
and  problem  correction. 

8.  Design  Patterns  Course  in  Computer  Science  Curriculum 

Design  Patterns  study  helps  to  solve  recurring  design  problems  by  using  common 
adopted  solutions.  Furthermore,  the  Design  Patterns  nomenclature  provides  a  precise 
way  of  communicating  design  ideas  among  software  engineers.  The  inclusion  of  a 
Design  Patterns  course  in  the  Computer  Science  and  MOVES  Curricula  is  highly 
recommended. 
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APPENDIX  A.  PREPARING  UML  DIAGRAMS  USING  RATIONAL  ROSE 


UML  Diagrams  Preparation 

Rational  Rose  version  98i  can  represent  the  following  types  of  UML  diagrams: 

,  Use  Case  Diagrams 

,  Class  Diagrams 

,  Collaboration  Diagrams 

,  Sequence  Diagrams 

,  Component  Diagrams 

•  Deployment  Diagrams 

The  program  is  capable  of  handling  different  models  (projects),  each  model  being  a  set  of 
basic  components  (classes,  interfaces,  actors  and  associations)  and  diagrams.  For  better 
visualization  the  project  is  organized  in  a  tree-like  structure  having  the  following  main 
branches: 

•  Use  Case  View  -  usually  contains  the  Use  Case  Diagrams  and  actors 
components. 

•  Logical  View  -  usually  contains  the  Class  Diagrams,  Collaboration  Diagrams 
Sequence  Diagrams,  Class  Components  and  Interface  Components. 

•  Component  View  -  contains  the  Component  Diagrams. 

•  Deployment  View  -  contains  a  Deployment  Diagram. 

To  create  a  new  diagram,  the  user  has  to  select  the  branch  he  wants  the  diagram  in,  click 
with  the  mouse  right  button  and  select  what  type  of  diagram  is  to  be  created.  A  new  blank 
diagram  is  shown  and  the  components  can  be  created  and  placed  on  the  diagram  by 
selecting  the  appropriate  component  in  a  tool  bar  and  clicking  in  the  place  the  component 
must  be  positioned  in  the  diagram.  Depending  on  the  type  of  the  component  different 
information  should  be  provided.  By  right  clicking  on  a  component  a  pull-down  menu  is 
shown  and  the  user  can  invoke  the  component  specification  as  long  as  the  option-setting 
feature. 

Reverse  Engineering  of  Java  Source  Code 

Reverse  engineering  is  the  process  of  creating  or  updating  a  model  by  analyzing  Java 
source  code.  As  Rational  Rose  reverse  engineers  each  .Java  or  .class  file,  it  finds  the 
classes  and  objects  in  the  file  and  includes  them  in  the  model. 
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To  reverse  engineer  all  or  part  of  a  Java  application: 

1 .  If  you  are  updating  an  existing  model,  open  the  model,  otherwise  create  a  new 
model. 

2.  On  the  Tools  menu,  point  to  Java,  and  then  click  Reverse  Engineer. 

3.  From  the  directory  structure  ,  select  the  classpath  setting  and  folder  where  the 
files  you're  reverse  engineering  are  located.  (If  the  list  is  empty,  check  your  classpath. 
For  details,  see  How  Rose  J  Models  the  Classpath  and  Extending  the  Java  Classpath  .) 

4.  Set  the  Filter  to  display  the  type  of  the  Java  files  whose  code  you  want  to  reverse 
engineer  (Java  or  .class  files). 

5.  Do  one  of  the  following  to  place  the  Java  files  of  the  type  you  selected  into  the 
Selected  Files  list: 

,     In  the  File  list  box,  select  one  or  more  individual  files  and  click  Add. 

.     Click  Add  All 

#     Click  Add  Recursive 

6.  Select  one  or  more  files  in  the  Selected  Files  box  or  click  Select  All  to  confirm  the 
list  of  files  to  reverse  engineer. 

7.  Click  Reverse  to  create  or  update  your  model  from  the  Java  source  you  specified. 
An  error  dialog  displays,  if  any  errors  occur  during  reverse  engineering. 

8.  Check  the  Rose  Log  for  a  listing  of  any  errors  that  might  have  occurred. 


The  procedure  above  is  described  in  the  Rational  Rose  Help.  An  additional  requirement 
for  reverse  engineering  of  Java  code  is  that  the  JDK  API  definitions  must  be  available  by 
adding  the  file  c .  \  j  dkl .  2  . 2  \  j  re \  1  ib\ rt .  j  ar t0  me  classpath. 

Using  the  reverse  engineering  feature,  Rational  Rose  will  import  from  Java  code  all 
classes,  interfaces  and  associations,  but  the  diagrams  are  not  automatically  generated. 
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APPENDIX  B.  RTPMONITOR  USER  MANUAL 


rtpMonitor  User  Manual 
version  1.0 


Contents: 

1 .  Execution 

2.  Defining  a  session 

3.  Session  Bookmarks 

4.  Preferences 

5.  Starting  a  session 

6.  Statistics 

7.  Stopping  a  session 

8.  Recording  monitoring  data 

9.  Using  the  monitor  without  GUI 

10.  Wrong  behaviors  and  results  (bugs) 

1 1 .  Running  the  program  in  other  directory 

12.  Reinstallation  recommendations 
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1.    Execution 

a)  In  the  command  line  type: 

cd    \vrtp\rtpMonitor 

java   org. web3d. vrtp. rtp. RtpMonitor 

b)  or  run  the  batch  file  rtpMonitor.bat  in  the  c:\vrtp\rtpMonitor  directory.  There  is  a 
Windows  shortcut  to  this  file  in  the  same  directory.  This  shortcut  can  be  copied  to  the 
Desktop  to  create  an  icon  for  the  rtpMonitor  program. 

Using  this  call  with  no  arguments  the  GUI  version  of  the  program  will  be  executed.  The 
following  window  is  presented: 


2. 


Ffe    Bookmarks    Preferences    Help 


Session  Address    rtp'if_ 


/ 


Session  Name 


Start 


Stop 


Total  Bytes 
Total  Packets 
RTCP  Packets 
SR  Packets 
Bad  RTP  Packets 
Bad  RTCP  Packets 
Bad  SR  Packets 
Bad  RR  Packets 

Active  Participants 


Global  Statistics 

Bad  SDES  Packets 
Bad  BYE  Packets 
Local  Collisions 
Remote  Collisions 
Looped  Packets 
Failed  Transmission 
Unknown  Type 


~3 


^ 


Passive  Participants 


31 


■    ■ 


Lil 


"-■"''    '  ". 


■■■:-■■        -     ■ 


Stream 


Usemame 


Lost  PDUs 
Processed  PDUs 
MisOrdered  PDUs 
Invalid  PDUs 
Duplicate  PDUs 

Feedback  Reports 
Fraction  Lost 


—~3 

Crrarrgej 


Jitter 


Packets  Lost 
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Defining  a  session 

In  the  session  box  enter  the  session  address/port/ttl  as  in  the  example  below: 
rtp://224.2.125.60:55690/127 

where  : 

Multicast  IP  address:  224.2.128.60 
RTP  port:  55690 
TTL  :  127 


3.    Session  Bookmarks 

As  an  option  to  writing  the  session  address,  it  is  possible  to  select  a  session  bookmark. 
The  program  already  comes  with  some  pre-defined  session  bookmarks.  Bookmarks  can 
be  added  and  deleted. 


g^RtpMonitor 


Fte 


Preferences    Help 


Select 


Ses~ 


Add 


Delete 


rtp://_ 


/ 


Total  Bytes 
Total  Packets 
RTCP  Packets 
SR  Packets 
Bad  RTP  Packets 
Bad  RTCP  Packets 
Bad  SR  Packets 
Bad  RR  Packets 

Active  Participants 


Global  Statistics 

Bad  SDES  Packets   [ 
Bad  BYE  Packets 
Local  Collisions 
Remote  Collisions    | 
Looped  Packets 
Failed  Transmission) 
Unknown  Type 


~B 


LiJ 


Id 


Passive  Participants 


Session  Name 


~2 


J 


Stream 


Username 


LostPDUs 
Processed  PDUs 
MisOrdered  PDUs 
Invalid  PDUs 
Duplicate  PDUs 

Feedback  Reports 
Fraction  Lost 


Start 


HBE3 


Stop 


~3 

Change! 


Jitter 


Packets  Lost 


~3 


zl 
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The  option  "Select"  displays  a  window  with  the  pre-defined  session  bookmarks.  Click 
over  the  desised  session  to  select  it. 


Select  Bookmark 


Dis-Java-Vrml  (video) 


Dis-Java-Vrml  (audio) 
DIS-Java-VRML(DIS  PDUs) 
Capitol  GMU  (video) 
Capitol  GMU  (audio) 
NasaTVtrom  HQ  (video) 
NasaTVfromHQ  (audio) 
Places  ail  over  world  ftideo) 


The  option  "Add"  allows  the  insertion  of  a  new  session  bookmark.  This  option  is  enabled 
only  when  a  session  has  been  started.  The  session  address  is  the  session  of  the  current 
session.  The  session  name  will  be  the  bookmark  name. 


ggAdd  Bookmark 


Session  Address:  rtp^/224.2.220.5:5641 4/1 27 


Session  Name      xvxtest 


Add 


Cancel 
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The  option  "delete"  allows  the  deletion  of  a  bookmark.  A  window  with  the  existing 
bookmarks  will  be  presented  and  the  user  can  select  the  bookmark  to  be  deleted  and  click 
the  "Delete"  button. 


fes  Delete  Bookmark 


0.!.?.d[3yaj-Vrml_.(vi  d  eg) 
Dis-Java-Vrml  (audio) 
DIS-Java-VRML  (DIS  PDUs) 
Capitol  GMU  (video) 
Capitol  GMU  (audio) 
Nasa  TV  from  HQ  (video) 
Nasa  TV  from  HQ  (audio) 
Places  all  over  world  (video) 


Delete 


Cancel 


4.    Preferences 

Before  starting  to  monitor  a  session,  the  user  should  set  up  the  program  preferences.  The 
menu  "Preferences"  allows  the  verification  and  modification  of  the  program  preferences. 
Selecting  Preferences  ->  Modify  the  following  window  will  be  presented: 


||2  Modify  Preferences 


F"  Send  RTCP  packets 
P*  Play  incoming  media 
P*  Record  statistics 


Record  lnterval(sec)     30.0 
Presentation lnterval(sec)  |5 
Monitoring  Period    Ji  hour      jH| 
External  viewer 

["CAProgram  Files\PFE  Programmers  File  Edito 
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The  options  are: 

•  Send  RTCP  packets  checkbox:  defines  if  the  monitor  will  participate  in  the 
session,  sending  RTCP  packets. 

•  Play  incoming  media  checkbox:  defines  if  the  monitor  will  play  the  received 
streams  (audio  or  video).  For  video,  a  new  playing  window  will  be  created  for 
each  active  participant  stream.  For  audio,  only  one  playing  window  will  be 
created. 

•  Record  statistics  checkbox:  defines  if  the  monitor  will  record  the  session  statistics 
in  files. 

•  Record  Interval  textbox:  the  user  can  enter  the  interval  between  recorded  data,  in 
seconds  (default  =  30  sec). 

•  Presentation  Interval  textbox:  the  user  can  enter  the  interval  between  data  updates 
on  screen,  in  seconds  ( default  =  5  sec). 

•  Monitoring  Period  choicebox:  allows  the  user  to  specify  the  duration  of  the 
monitoring  session.  After  the  time  is  over  the  program  will  exit  automatically. 
The  maximum  allowed  duration  is  one  week  (default  =  1  hour). 

•  External  viewer  textbox:  defines  an  external  text  editor  that  will  be  called  to 
present  the  output  files  generated  by  the  monitor  ( default  =  MS  Windows 
Wordpad ). 

The  selected  preferences  will  be  saved  on  file  and  will  be  available  in  the  next  time  the 
program  is  executed. 

5.  Starting  a  session 

After  entering  the  session  address  and  the  desired  option,  the  user  can  click  on  the  start 
button  to  start  a  monitoring  session.  If  the  supplied  session  address  is  invalid  or  if  any 
other  problem  in  establishing  a  session  occurs  an  error  message  will  be  displayed  in  the 
feedback  text  area. 

6.  Statistics 

The  program  displays  the  following  types  of  information  about  the  session: 

•  Global  statistics:  general  information  about  the  whole  session. 

•  Active  Participants:  the  username  of  the  participants  actually  sending  data 
streams. 

•  Passive  Participants:  the  username  of  the  participants  that  do  not  send  any  stream. 

•  Stream:  the  stream  that  is  currently  being  monitored.  That  stream  can  be  changed 
in  a  session  with  multiple  incoming  streams  by  clicking  in  the  "change"  button 
and  selecting  another  stream  in  the  stream  selection  box. 

•  Feedback:  that  display  area  presents  the  RTCP  feedback  data  related  to  the 
selected  stream.  Usually  the  participants  in  the  session  send  feedback  data  about 
all  streams. 
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7.    Stopping  a  session 

Clicking  the  "stop"  button  can  stop  a  session.  After  stopping  a  session,  the  user  is  allowed 
to  change  the  session  address  and  preferences  before  starting  monitoring  again. 


8.    Recording  monitoring  data 

A  new  subdirectory  is  created  for  each  session  address,  with  the  following  name: 
session  [IPaddress]  port  [port  number] 

Inside  this  subdirectory  several  files  will  be  generated  and  updated  during  a  recording 
session.  They  are: 

•  statisticsHeader.txt:  contains  the  description  of  the  fields  being  stored. 

•  statisticsLastFiveMinutes.txt:  contains  the  last  five  minutes  block  of  statistics. 

•  statisticsPreviousFiveMinutes.txt:  contains  the  previous  five  minutes  block  of 
statistics. 

•  statisticsLastHour.txt:  contains  the  last  hour  block  of  statistics. 

•  statisticsPreviousHour.txt:  contains  the  previous  hour  block  of  statistics. 

•  statisticsDateMM-DD-YYYY:  contains  statistics  taken  in  described  date. 

•  statisticsLastReport.txt  -  contains  the  last  single  report. 

There  is  also  a  file  called  LastDateRef.txt,  which  contains  the  last  monitoring  date  for 
that  session.  It  is  possible  to  see  some  of  these  files  using  the  menu  "File". 
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^RtpMonitor 


Bookmarks    Preferences    Hek) 
Last  five  minutes 
Previous  five  minutes 
Last  hour 
Previous  hour 


.2.203.37:60068/127 


Heacjer 


U  <JI      I    UlllllJ 


Session  Name  I  Nasa  TV  from  HQ  (video) 


Global  Statistics 

Bad  SDES  Packets 


SR  Packets 
Bad  RTP  Packets 
Bad  RTCP  Packets 
Bad  SR  Packets 
Bad  RR  Packets 


Bad  BYE  Packets 
Local  Collisions 
Remote  Collisions    | 
Looped  Packets 
Failed  Transmission!" 
Unknown  Type 

Passive  Participants 


Start 


HHE 


Stop 


Stream 


Lost  PDUs 
Processed  PDUs  f 
MisOrdered  PDUs  [~ 
Invalid  PDUs 
Duplicate  PDUs 

Feedback  Reports 


~~3 

Changs! 


Username 

Fraction  Lost 

Jitter 

Packets  Lost 

^ 

'.V 

:« 

V    %     i 

f*f*j 

zl 

The  external  viewer  defined  in  the  preferences  will  be  called  to  present  the  output  files. 
These  options  can  be  executed  during  a  monitoring  session.  Below  is  an  example  of  the 
Last  five  minutes  file  using  MS  Windows  WordPad  editor  as  an  external  viewer.  The 
format  of  the  data  is  stored  in  the  file  statisticsHeader.txt,  also  shown  below. 
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§H  statist  icsLastFiveMiruites.txt  -  Notepad 


file    £dit    Search    Help 


HEE3I 


[D1    10:25:27   9   8   1    5651647   6334   358   27    00000000080 

D2   ellery@131.182.10.250  1564101640  903   5976    0   0   0 

D3   joelja@128.223.214.27   1569838982   1564101640   0.0  8    0 

D3   brutzman@accelerate  4285065786   1564101640   0.0390625   803   3026 

D3   ellery@131.182.10.250  1564101640  1564101640   0.0  1    0 

D3   miyake@128.223.83.29   1568747521    1564101640   0.0  40   0 

D3   nmei@141.78.3.242   398571242   1564101640   0.0546875   17478    0 

D1    10:25:57   9   8   1    6893963   7723   428   33    00000000000 

D2   ellery@131.182.10.250  1564101640  967   7296    0   0   0 

D3   joelja@128.223.214.27   1569838982   1564101640   0.0  8    0 

D3  brutzman@accelerate   4285065786   1564101640  0.09375   918   3047 

D3   ellery@131.182.10.250   1564101640  1564101640   0.0  1    0 

D3   niyake@128.223.83.29   1568747521    1564101640   0.0  42    0 

D3   line i@1 41. 78. 3. 242   398571242   1564101640   0.1015625   17614   0 

D1    10:26:27   9   8   1    8225068   9184  497   38    00000000000 

D2   ellery@131.182.16.250  1564101640  1069   8688    0   0   0 

D3   joelja@128.223.214.27   1569838982   1564101640   0.0  8    0 

D3  brutzman@accelerate   4285065786   1564101640   0.0546875  1023  2953 

D3  ellery@131.182.10.250  1564101640  1564101640  0.0  1    0 

D3   niyake@128.223.83.29   1568747521    1564101640   0.0  44   0 

D3   nmei@141.78.3.242   398571242   1564101640   0.08984375   17730   0 

D1    10:26:57   9   8   1    9499537   10587   556   43    00000000000 

D2   ellery@131.182.10.250  1564101640  1214  10031    0   0   0 

D3    joelja@128.223.214.27   1569838982   1564101640   0.0   8    0 

D3   brutznan@accelerate   4285065786   1564101640  0.015625  1043   3332 

D3   ellery@131  .182.10.250  1564101640  1564101640   0.0   1    0 

D3   niyake@128.223.83.29   1568747521    1564101640   0.0  44   0 

D3   mneidl 41 .78.3.242   398571242   1564101640   0.08984375   17866    0 

D1    10:27:27   9   8   1    10912065   12114  627   47   00000000000 

D2   ellery@131.182.10.250  1564101640   1230   11488    0   0   0 

D3   joelja@128.223.214.27   1569838982   1564101640   0.0  8    0 


/a 


I  statisticsHeader.txt  -  Notepad 


Fte    £cft    Search    Help 


BHE3 


H1  Tine  TotalParticipants  RenoteParticipants  flctiueParticipants  TotalBytes^ 
H2  CNAME  SSRC  LostPDU  ProcessedPDU  HisorderedPDU  InualidPDU  DuplicatePDU 
H3  CNAME  FronSSRC  AboutSSRC  FractionLost  PacketsLost  Jitter 

±i : i 


Each  line  of  data  is  preceded  with  a  header  indicator  (Dl,  D2  or  D3),  which  indicates  the 
line  of  the  statisticsHeader  file  that  contains  the  description  of  the  data  being  stored  (HI, 
H2  or  H3). 
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9.    Using  the  monitor  without  GUI 

The  program  can  be  executed  without  the  GUI  (no  statistics  are  presented)  by  passing  the 
session  address  and  options  data  via  the  command  line.  The  format  is: 

Java  org.web3d.vrtp.rtp.RtpMonitor  sessionAddress  [options] 

The  options  are: 

-part :  the  monitor  participates  in  the  session  (sends  RTCP  packets  as  a  receiver  in 
the  session) 

-play  :  the  monitor  play  streams 

-record  :  the  monitor  records  statistics 

-i  nnn  :  nnn  defines  the  recording  interval  in  seconds  (default  30s) 

-e  ppp  :  ppp  defines  the  monitoring  duration  in  hours  (default:  1 68  hours  =  1 
week) 

-help:  displays  the  options  on  the  console. 


Example:    Java    org.web3d.vrtp.  rtp.  RtpMonitor 

rtp://224. 120.  67.  46/64542/127   -play   -record   -e   24 

Action:  runs  the  program  for  monitoring  the  session  in  the  IP  address  224.120.67.46, 
port  64542,  with  TTL  =  127.  It  does  not  participate  in  the  session,  but  plays  the  incoming 
streams  and  records  statistics  on  files.  The  recording  interval  will  be  30  seconds  and  the 
monitoring  duration  will  be  24  hours. 
To  stop  the  program  press  <Ctrl-C-> 


10.  Wrong  behaviors  and  results  (bugs) 

Several  early  bugs  were  related  to  JMF1.1  and  were  corrected  in  JMF2.0  Early  Access.  A 
new  bug  was  observed  in  JMF  2.0  Early  Access:  the  Cumulative  Number  of  Packets  Lost 
(  Packets  Lost  in  the  Feedback  Area  )  is  returning  wrong  values  after  some  time.  This 
problem  was  reported  to  Sun's  JMF-bugs  list  in  08-Jun-1999,  but  it  is  still  present  in 
JMF2.0  Beta. 
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11.  Running  the  program  in  other  directory 

To  run  the  program  in  another  directory  copy  the  files  "bookmarks.txt"  and  "Header.txt" 

to  the  new  directory.  Then  run  rtpMonitor  from  this  directory. 

Example: 

copy  bookmarks .  txt  c: \Mydir 

copy  Header,  txt   c: \Mydir 

cd    \Mydir 

Java    org. web3d. vrtp. rtp. RtpMonitor 


12.  Reinstallation  recommendations 

In  order  to  continue  using  the  previous  bookmarks  and  preferences,  the  files 
"bookmark.txt"  and  "preferences.txt"  in  the  directory  "\vrtp\rtpMonitor"  should  be  saved 
and  restored  after  the  new  installation. 

To  reinstall  the  program  it  is  recommended  the  deletion  of  the  following  directories: 

-  \vrtp\javadoc\rtpMonitor 

-  \vrtp\org\web3d\vrtp\rtp 

-  \vrtp\rtpMonitor 
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APPENDIX  C.  RTPMONITORJAVADOC 
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Package  Class  Tree  Deprecated  Index  Help 


PREV PACKAGE  NEXT  PACKAGE 


FRAMES  NO  FRAMES 


Package  org.web3d.vrtp.rtp 


Class  Summary 

About 

A  Dialog  to  display  information  about  the  program  e.g. 

AddBookmark 

The  Dialog  to  add  a  session  bookmark. 

CloseWindow 

This  class  is  used  to  set  a  frame/dialog  as  not  visible  when  the 
close  icon  is  clicked. 

DeleteBookmark 

A  Dialog  to  delete  a  session  bookmark. 

DisplayTask 

A  class  used  by  RtpMonitor  objects  to  periodically  launch 
their  showStats  methods  (screen  updates). 

FileCatalog 

A  class  used  by  RecordTask  objects  to  organize  statistics  in 
several  files  (  five  minutes,  hour,  and  day ). 

ModifyPreferences 

A  Dialog  to  display  and  modify  the  program  preferences. 

RecordTask 

A  class  used  by  RtpMonitorManager  objects  to  write  the 
statistics  periodically  to  disk. 

RtpMediaLocator 

A  class  that  represents  necessary  information  to  define  an 
RTP  session,  as  address,  port  and  TTL. 

RtpMonitor 

The  RtpMonitor  Application. 

RtpMonitorCommandLine 

A  class  used  to  start  a  RTP  monitor  from  command  line 
inputs. 

RtpMonitorManager 

A  class  that  encapsulates  all  operations  necessary  to  start  a 
new  monitoring  session,  play  its  streams,  and  record  statistical 
data. 

RtpPlayerWindow 

This  class  is  used  to  create  a  window  for  playing  an 
audio/video  stream. 

RtpUtil 

A  class  with  some  RTP  utilities  (static  methods) 

SelectBookmark 

A  Dialog  to  select  a  session  bookmark. 
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org.web3d.vrtp.rtp 

Class  About 

j  a va . lang. Object 
I 

+-- java . awt . Component 
I 

+--java . awt . Container 
I 

+-- j  ava . awt . Window 
I 

h java . awt .Dialog 

I 

+--org. web3d. vrtp. rtp. About 


public  class  About 
extends  java.awt. Dialog 

A  Dialog  to  display  information  about  the  program  e.g.  version,  date 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 
See  Also: 

Serialized  Form 


Fields  inherited  from  class  java.awt.Component 


BOTTOM_ALIGNMENT,  CENTER_ALIGNMENT,  LEFT_ALIGNMENT,  RIGHT_ALIGNMENT, 
TOP  ALIGNMENT 


Constructor  Summary 


About ( j  ava . awt . Frame  parent' 
Constructor. 


Methods  inherited  from  class  java.awt.Dialog 


addNotify,  dispose,  getTitle,  hide,  isModal,  isResizable,  setModal, 
setResizable,  setTitle,  show 


03 


Methods  inherited  from  class  java.awt.  Window 


addWindowListener,  applyResourceBundle,  applyResourceBundle, 
getFocusOwner,  getlnputContext ,  getLocale,  getOwnedWindows,  getOwner, 
getToolkit,  getWarningString,  isShowing,  pack,  postEvent, 
removeWindowListener,  setCursor,  toBack,  toFront 


Methods  inherited  from  class  java.awt.Container 


add,  add,  add,  add,  add,  addContainerListener,  countComponents, 
deliverEvent,  de-Layout,  f  indComponentAt,  f indComponentAt ,  getAlignmentX, 
getAlignmentY,  getComponent,  getComponentAt ,  getComponentAt , 
getComponentCount,  getComponents,  getlnsets,  getLayout,  getMaximumSize, 
getMinimumSize,  getPref erredSize,  insets,  invalidate,  isAncestorOf , 
layout,  list,  list,  locate,  minimurnSize,  paint,  paintComponents, 
preferredSize,  print,  printComponents,  remove,  remove,  removeAll, 
removeContainerListener,  removeNotif y,  setFont,  setLayout,  update, 
validate 


Methods  inherited  from  class  java.awt.Component 


action,  add,  addComponentListener,  addFocusListener, 
addlnputMethodListener,  addKeyListener,  addMouseListener, 
addMouseMotionListener,  addPropertyChangeListener, 

addPropertyChangeListener,  bounds,  checklmage,  checklmage,  contains, 
contains,  createlmage,  createlmage,  disable,  dispatchEvent ,  enable, 
enable,  enablelnputMethods,  getBackground,  getBounds,  getBounds, 
getColorModel,  getComponentOrientation,  getCursor,  getDropTarget,  getFont, 
getFontMetrics,  getForeground,  getGraphics,  getHeight, 

getlnputMethodRequests,  getLocation,  getLocation,  getLocationOnScreen, 
getName,  getParent,  getPeer,  getSize,  getSize,  getTreeLock,  getWidth, 
getX,  getY,  gotFocus,  handleEvent,  hasFocus,  imageUpdate,  inside, 
isDisplayable,  isDoubleBuf fered,  isEnabled,  isFocusTraversable, 
isLightweight ,  isOpaque,  isValid,  isVisible,  keyDown,  keyUp,  list,  list, 
list,  location,  lostFocus,  mouseDown,  mouseDrag,  mouseEnter,  mouseExit, 
mouseMove,  mouseUp,  move,  nextFocus,  paintAll,  preparelmage,  preparelmage, 
printAll,  remove,  removeComponentListener,  removeFocusListener, 
remove Input Me thodListener,  removeKeyListener,  removeMouseListener, 
removeMouseMotionListener,  removePropertyChangeListener, 
removePropertyChangeListener,  repaint,  repaint,  repaint,  repaint, 
requestFocus,  reshape,  resize,  resize,  setBackground,  setBounds, 
setBounds,  setComponentOrientation,  setDropTarget ,  setEnabled, 
setForeground,  setLocale,  setLocation,  setLocation,  setName,  setSize, 
setSize,  setVisible,  show,  size,  toString,  transf erFocus 


Methods  inherited  from  class  java.lang.Object 


equals,  getClass,  hashCode,  notify,  notifyAll,  wait,  wait,  wait 


Constructor  Detail 


About 


public  About (java . awt . Frame  parent 
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Constructor. 

Parameters: 

parent  -  the  parent  frame 
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org.web3d.vrtp.rtp 

Class  AddBookmark 

Java . lang. Object 
I 

+  -- j  ava . awt . Component 
I 

+-- j  ava . awt . Container 
I 

+  -- j  ava . awt . Window 
I 


+-- java . awt . Dialog 
I 
+  --org.  web3d.  vrtp.  rtp .  AddBookmark 


public  class  AddBookmark 

extends  java.awt.Dialog 

implements  java.awt.event.ActionListener 

The  Dialog  to  add  a  session  bookmark. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 
See  Also: 

Serialized  Form 


Fields  inherited  from  class  java.awt.Component 


BOTTOM_ALIGNMENT,  CENTER_ALIGNMENT,  LEFT_ALIGNMENT,  RIGHT_ALIGNMENT, 
TOP  ALIGNMENT 


Constructor  Summary 


AddBookmark ( j  ava . awt . Frame   parent 
Constructor. 


Method  Summary 


void 


actionPerf ormed ( Java . awt . event . Act ionE vent  e] 


Takes  action  when  buttons  are  selected. 
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Methods  inherited  from  class  java.awt.Dialog 


adclNotif y,  dispose,  getTitle,  hide,  isModal,  isResizable,  setModal, 
setResizable,  setTitle,  show 


Methods  inherited  from  class  java.awt. Window 


addWindowListener,  applyResourceBundle,  applyResourceBundle, 
getFocusOwner,  getlnputContext,  getLocale,  getOwnedWindows,  getOwner, 
getToolkit,  getWarningString,  isShowing,  pack,  postEvent, 
removeWindowListener,  setCursor,  toBack,  toFront 


Methods  inherited  from  class  java.awt.Container 


add,  add,  add,  add,  add,  addContainerListener,  countComponents, 
deliverEvent,  doLayout,  f indComponentAt,  f indComponentAt ,  getAlignmentX, 
getAlignmentY,  getComponent ,  getComponentAt,  getComponentAt, 
getComponentCount,  getComponents,  getlnsets,  getLayout,  getMaximumSize, 
getMinimumSize,  getPref erredSize,  insets,  invalidate,  isAncestorOf , 
layout,  list,  list,  locate,  minimumSize,  paint,  paintComponents, 
preferredSize,  print,  printComponents,  remove,  remove,  removeAll, 
removeContainerListener,  removeNotif y,  setFont,  setLayout,  update, 
validate 


Methods  inherited  from  class  java.awt.Component 


action,  add,  addComponentListener,  addFocusListener, 
addlnputMethodListener,  addKeyListener,  addMouseListener, 
addMouseMotionListener,  addPropertyChangeListener, 

addPropertyChangeListener,  bounds,  checklmage,  checklmage,  contains, 
contains,  createlmage,  createlmage,  disable,  dispatchEvent,  enable, 
enable,  enablelnputMethods,  getBackground,  getBounds,  getBounds, 
getColorModel,  getComponentOrientation,  getCursor,  getDropTarget ,  getFont, 
getFontMetrics,  getForeground,  getGraphics,  getHeight, 

getlnputMethodRequests,  getLocation,  getLocation,  getLocationOnScreen, 
getName,  getParent,  getPeer,  getSize,  getSize,  getTreeLock,  getWidth, 
getX,  getY,  gotFocus,  handleEvent,  hasFocus,  imageUpdate,  inside, 
isDisplayable,  isDoubleBuf f ered,  isEnabled,  isFocusTraversable, 
isLightweight,  isOpaque,  isValid,  isVisible,  keyDown,  keyUp,  list,  list, 
list,  location,  lostFocus,  mouseDown,  mouseDrag,  mouseEnter,  mouseExit, 
mouseMove,  mouseUp,  move,  nextFocus,  paintAll,  preparelmage,  preparelmage, 
printAll,  remove,  removeComponentListener,  removeFocusListener, 
r emo ve Input Me thodListener,  removeKeyListener,  removeMouseListener, 
removeMouseMotionListener,  removePropertyChangeListener, 
removePropertyChangeListener,  repaint,  repaint,  repaint,  repaint, 
requestFocus,  reshape,  resize,  resize,  setBackground,  setBounds, 
setBounds,  setComponentOrientation,  setDropTarget,  setEnabled, 
setForeground,  setLocale,  setLocation,  setLocation,  setName,  setSize, 
setSize,  setVisible,  show,  size,  toString,  transferFocus 


Methods  inherited  from  class  java.lang.Object 

equals,    getClass,    hashCode,    notify,    notifyAll, 

wait, 

wait, 

wait 

Constructor  Detail 
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AddBookmark 

public  AddBookmark (java . awt . Frame   parent 
Constructor. 

Parameters: 

parent  -  the  parent  frame 


Method  Detail 


actionPerformed 

public   void  actionPerformed ( java . awt . event .ActionEvent    e) 

Takes  action  when  buttons  are  selected. 
Specified  by: 

actionPerformed  in  interface  java.awt.event.ActionListener 


Class  Tree  Deprecated  Index  Help 

PREV  CLASS    NEXT  CLASS 

SUMMARY:   INNER  1  FIELD  1  CONSTR  |  METHOD 

FRAMES     NO  FRAMES 

DETAIL:   FIELD  1  CONSTR  |  METHOD 

98 


Class  Tree  Deprecated  Index  Help 


PREV  CLASS    NEXT  CLASS  FRAMES     NO  FRAMES 

SUMMARY:   INNER  I  FIELD  1  CONSTR  |  METHOD  DETAIL:   FIELD  I  CONSTR  [  METHOD 


org.web3d.vrtp.rtp 

Class  CloseWindow 

j  ava . lang . Ob j  ect 
I 

+-- Java . awt . event . WindowAdapter 
I 
+  --org.  web3d.  vrtp.  rtp.  CloseWindow 


public  class  CloseWindow 

extends  java.awt.e  vent.  WindowAdapter 

This  class  is  used  to  set  a  frame/dialog  as  not  visible  when  the  close  icon  is  clicked. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 


Constructor  Summary 


CloseWindow 


Method  Summary 


void 


windowClosing ( j  ava . awt . event . WindowEvent  e] 


set  frame/dialog  as  not  visible. 


Methods  inherited  from  class  java.awt.event.Window Adapter 


windowActivated,    windowClosed,    windowDeactivated,    windowDeiconif ied, 
windowlconif ied,    windowOpened 


Methods  inherited  from  class  java.lang.Object 


equals,    getClass,    hashCode,    notify,    notifyAll,    toString,    wait,    wait,    wait 


Constructor  Detail 
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CloseWindow 

public  CloseWindow 


Method  Detail 


windowClosing 

public  void  windowClosing (Java . awt . event . WindowEvent  e) 

set  frame/dialog  as  not  visible.  This  method  is  activated  when  the  window  is  closed. 
Overrides: 

windowClosing  in  class  java.awt.event.WindowAdapter 
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org.web3d.vrtp.rtp 

Class  DeleteBookmark 

j  ava . lang . Ob j  ect 
I 

+  —  j  ava . awt . Component 
I 

+-- Java . awt . Container 
I 

+-- Java . awt .Window 
I 

+ — java . awt . Dialog 
I 
+— org . web3d . vrtp . rtp . DeleteBookmark 


public  class  DeleteBookmark 

extends  java. awt. Dialog 

implements  java.awt.event.ActionListener 

A  Dialog  to  delete  a  session  bookmark. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 
See  Also: 

Serialized  Form 


Fields  inherited  from  class  java.awt.Component 


80TT0M_ALIGNMENT,  CENTER_ALIGNMENT,  LEFT_ALIGNMENT,  RIGHT_ALIGNMENT, 
TOP  ALIGNMENT 


Constructor  Summary 


DeleteBookmark ( j  ava . awt . Frame  parent 


Constructor. 


Method  Summary 


void 


actionPerf ormed ( j  ava . awt . event . ActionEvent  e) 


Takes  action  when  buttons  are  selected. 
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Methods  inherited  from  class  Java. awt. Dialog 


addNotif y,  dispose,  getTitle,  hide,  isModal,  isResizable,  setModal, 
setResizable,  setTitle,  show 


Methods  inherited  from  class  java.awt.Window 


addWindowListener,  applyResourceBundle,  applyResourceBundle, 
getFocusOwner,  getlnputContext ,  getLocale,  getOwnedWindows,  getOwner, 
getToolkit,  getWarningString,  isShowing,  pack,  postEvent, 
removeWindowListener,  setCursor,  toBack,  toFront 


Methods  inherited  from  class  java.awt.Container 


add,  add,  add,  add,  add,  a 
deliverEvent,  doLayout,  fi 
getAlignmentY,  getComponen 
getComponentCount,  getComp 
getMinimumSize,  getPreferr 
layout,  list,  list,  locate 
preferredSize,  print,  prin 
removeContainerListener,  r 
validate 


ddContainerListener,  count Components, 
ndComponentAt,  f indComponentAt ,  getAlignmentX, 
t,  getComponentAt ,  getComponentAt , 
onents,  getlnsets,  getLayout,  getMaximumSize, 
edSize,  insets,  invalidate,  isAncestorOf , 

minimumSize,  paint,  paintComponents, 
tComponents,  remove,  remove,  removeAll, 
emoveNotify,  setFont,  setLayout,  update, 


Methods  inherited  from  class  java.awt.Component 


action,  add,  addComponentListener,  addFocusListener, 
addlnputMethodListener,  addKeyListener,  addMouseListener, 
addMouseMotionListener,  addPropertyChangeListener, 

addPropertyChangeListener,  bounds,  checklmage,  checklmage,  contains, 
contains,  createlmage,  createlmage,  disable,  dispatchEvent ,  enable, 
enable,  enablelnputMethods,  getBackground,  getBounds,  getBounds, 
getColorModel,  getComponentOrientation,  getCursor,  getDropTarget,  getFont, 
getFontMetrics,  getForeground,  getGraphics,  getHeight, 

getlnputMethodRequests,  getLocation,  getLocation,  getLocationOnScreen, 
getName,  getParent,  getPeer,  getSize,  getSize,  getTreeLock,  getWidth, 
getX,  getY,  gotFocus,  handleEvent,  hasFocus,  imageUpdate,  inside, 
isDisplayable,  isDoubleBuf f ered,  isEnabled,  isFocusTraversable, 
isLightweight,  isOpaque,  isValid,  isVisible,  keyDown,  keyUp,  list,  list, 
list,  location,  lostFocus,  mouseDown,  mouseDrag,  mouseEnter,  mouseExit, 
mouseMove,  mouseUp,  move,  nextFocus,  paintAll,  preparelmage,  preparelmage, 
printAll,  remove,  removeComponentListener,  removeFocusListener, 
r emo ve Input Me thodListener,  removeKeyListener,  removeMouseListener, 
removeMouseMotionListener,  removePropertyChangeListener, 
removePropertyChangeListener,  repaint,  repaint,  repaint,  repaint, 
requestFocus,  reshape,  resize,  resize,  setBackground,  setBounds, 
setBounds,  setComponentOrientation,  setDropTarget,  setEnabled, 
setForeground,  setLocale,  setLocation,  setLocation,  setName,  setSize, 
setSize,  setVisible,  show,  size,  toString,  transferFocus 


Methods  inherited  from  class  java.lang.Object 

equals,    getClass,    hashCode,    notify,    notifyAll, 

wait, 

wait, 

wait 

Constructor  Detail 
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DeleteBookmark 

public  DeleteBookmark (Java . awt . Frame  parent; 

Constructor. 

Parameters: 

parent  -  the  parent  frame 


Method  Detail 


actionPerformed 

public  void  actionPerformed (j ava . awt . event .Act ionEvent  e) 

Takes  action  when  buttons  are  selected. 
Specified  by: 

actionPerformed  in  interface  java.awt.event.ActionListener 
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org.web3d.vrtp.rtp 

Class  DisplayTask 

java . lang. Object 
I 
+--org . web3d . vrtp . rtp . DisplayTask 


public  class  DisplayTask 

extends  java. lang. Object 
implements  java. lang. Runnable 

A  class  used  by  RtpMonitor  objects  to  periodically  launch  their  showStats  methods  (screen 
updates). 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 


Constructor  Summary 


DisplayTask (RtpMonitor  mon,  double  interval] 
Constructor. 


Method  Summary 


void 


run 


This  method  runs  continuously  calling  the  showStats  methods  of  RtpMonitor  in 
the  proper  presentation  interval,  until  the  RtpMonitor  stops  the  session. 


Methods  inherited  from  class  java.lang.Object 


equals,    getClass,    hashCode,    notify,    notifyAll,    toString,    wait,    wait,    wait 


Constructor  Detail 


DisplayTask 


public  DisplayTask (RtpMonitor  mon, 

double  interval) 
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Constructor.  It  creates  a  new  thread  of  execution  and  calls  the  method  run(). 
Parameters: 

mon  -  the  RtpMonitor  object  that  will  be  called  back  for  screen  updates. 
interval  -  the  interval  between  screen  data  updates,  in  seconds. 


Method  Detail 


run 


public   void  run ( ) 


This  method  runs  continuously  calling  the  showStats  methods  of  RtpMonitor  in  the 
proper  presentation  interval,  until  the  RtpMonitor  stops  the  session. 
Specified  by: 

run  in  interface  Java. lang.Runnable 
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org.web3d.vrtp.rtp 

Class  FileCatalog 

j  ava . lang . Ob j  ect 
I 
+--org. web3d. vrtp. rtp. FileCatalog 


public  class  FileCatalog 
extends  java.lang.Object 

A  class  used  by  RecordTask  objects  to  organize  statistics  in  several  files  (  five  minutes,  hour, 
and  day ). 

This  class  writes  to  the  file  following  files:  statisticsLastFiveMinutes.txt, 
statisticsPreviousFiveMinutes.txt,  statisticsLastHour.txt,  statisticsPreviousFiveMinutes.txt, 
and  statisticsDateMM-DD-YYYY.txt. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 


Constructor  Summary 


FileCatalog ( j  ava ■ lang . String  pref! 

Constructor. 


Method  Summary 


static   void 


concatenate ( j  ava . lang . String   filel,    Java . lang . String    file2 
Utility  to  concatenate  two  files. 


2 ava . lang. String 


retrieveDateRef ( ) 

This  method  retrives  a  date  in  a  string  format  from  the  file 
statisticsLastDateRef.txt. 


void 


saveDateRef ( j  ava . lang . String  dater) 

This  method  saves  in  a  file  a  date  in  a  string  format. 


void 


update (java . util . Calendar  time) 

Method  that  will  update  the  files,  transfering  data  from 
statisticsLastReport.txt  to  the  appropriate  files. 
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Methods  inherited  from  class  java.lang.Object 


equals,    getClass,    hashCode,    notify,    notifyAll,    toString,    wait,    wait,    wait 


Constructor  Detail 


FileCatalog 

public  FileCatalog (j ava . lang. String  pref) 

Constructor.  It  checks  if  there  are  previous  data  from  the  same  session  and  transfers 
these  data  to  the  correct  statisticsDateMM-DD_YYYY.txt  file.  Then  it  clears  all  "five 
minutes"  and  "hour"  data  files. 

Parameters: 

pref  -  a  string  containing  the  directory  where  the  data  must  be  written 


Method  Detail 


update 

public  void  update (Java . util . Calendar  time) 

Method  that  will  update  the  files,  transfering  data  from  statisticsLastReport.txt  to  the 

appropriate  files. 

Parameters: 

time  -  the  current  time  as  a  Calendar  object. 

concatenate 

public  static  void  concatenate (Java . lang. String  filel, 

java. lang. String  file2) 

Utility  to  concatenate  two  files. 
Parameters: 

filel  -  the  first  file  (  filel  <-  filel  +  file2  ).  If  file  1  does  not  exits  this  method 
will  copy  file2  to  filel . 

file2  -  the  file  to  be  appended  to  filel. 


saveDateRef 

public  void  saveDateRef (j ava . lang. String  dater] 
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This  method  saves  in  a  file  a  date  in  a  string  format.  It  is  used  for  save  the  date  of  the 

last  report.  The  file  name  is  statisticsLastDateRef.txt. 

Parameters: 

dater  -  a  string  representing  a  date  as  DD-MM-YYYY 


retrieveDateRef 

public  Java . lang . String  retrieveDateRef ( ) 

This  method  retrives  a  date  in  a  string  format  from  the  file  statisticsLastDateRef.txt. 
Returns: 

string  representing  a  date  as  DD-MM-YYYY 
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org.web3d.vrtp.rtp 

Class  ModifyPreferences 

Java . lang. Object 
I 

+  -- j  ava . awt . Component 
I 

+--java . awt .Container 
I 

+  -- j  ava . awt . Window 
I 

+  -- j  ava . awt . Dialog 
I 
+- -org . web3d . vrtp . r tp . ModifyPreferences 


public  class  ModifyPreferences 

extends  java.awt.Dialog 

A  Dialog  to  display  and  modify  the  program  preferences. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 
See  Also: 

Serialized  Form 


Fields  inherited  from  class  java.awt.Component 


BOTTOM_ALIGNMENT,  CENTER_ALIGNMENT,  LEFT_ALIGNMENT,  RIGHT_ALIGNMENT, 
TOP  ALIGNMENT 


Constructor  Summary 


ModifyPreferences ( j  ava . awt . Frame   parent) 
Constructor. 
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Method  Summary 


void 


disablelnput ( ) 

Disables  the  GUI  input  elements 


void 


enablelnput ( ) 

Enables  the  GUI  input  elements 


void 


savePreferences 


Saves  the  preferences  in  the  file  preferences.txt 


Methods  inherited  from  class  java.awt.Dialog 


addNotify,    dispose,    getTitle,    hide,    isModal,    isResizable,    setModal, 
setResizable,    setTitle,    show 


Methods  inherited  from  class  java.awt. Window 


addWindowListener,    applyResourceBundle,    applyResourceBundle, 
getFocusOwner,    getlnputContext ,    getLocale,    getOwnedWindows,    getOwner, 
getToolkit,    getWarningString,    isShowing,    pack,    postEvent, 
removeWindowListener,    setCursor,    toBack,    toFront 


Methods  inherited  from  class  java.awt.Container 


add,    add,    add, 

deliverEvent, 

getAlignmentY, 

get Component Co 

getMinimumSize 

layout,  list, 

preferredSize, 

removeContaine 

validate 


add,  add,  addContainerListener,  countComponents, 
doLayout,  f indComponentAt,  f indComponentAt,  getAlignmentX, 

getComponent,  getComponentAt ,  getComponentAt , 
unt,  getComponents,  getlnsets,  getLayout,  getMaximumSize, 
,  getPreferredSize,  insets,  invalidate,  isAncestorOf , 
list,  locate,  minimumSize,  paint,  paintComponents, 

print,  printComponents,  remove,  remove,  removeAll, 
rListener,  removeNotif y,  setFont,  setLayout,  update, 


Methods  inherited  from  class  java.awt.Component 


action,  add,  addComponentListener,  addFocusListener, 
addlnputMethodListener,  addKeyListener,  addMouseListener, 
addMouseMotionListener,  addPropertyChangeListener, 

addPropertyChangeListener,  bounds,  checklmage,  checklmage,  contains, 
contains,  createlmage,  createlmage,  disable,  dispatchEvent ,  enable, 
enable,  enablelnputMethods,  getBackground,  getBounds,  getBounds, 
getColorModel,  getComponentOrientation,  getCursor,  getDropTarget ,  getFont, 
getFontMetrics,  getForeground,  getGraphics,  getHeight, 

getlnputMethodRequests,  getLocation,  getLocation,  getLocationOnScreen, 
getName,  getParent,  getPeer,  getSize,  getSize,  getTreeLock,  getWidth, 
getX,  getY,  gotFocus,  handleEvent,  hasFocus,  imageUpdate,  inside, 
isDisplayable,  isDoubleBuf f ered,  isEnabled,  isFocusTraversable, 
isLightweight,  isOpaque,  isValid,  isVisible,  keyDown,  keyUp,  list,  list, 
list,  location,  lostFocus,  mouseDown,  mouseDrag,  mouseEnter,  mouseExit, 
mouseMove,  mouseUp,  move,  nextFocus,  paintAll,  preparelmage,  preparelmage, 
printAll,  remove,  removeComponentListener,  removeFocusListener, 
r emo ve Input Me thodListener,  removeKey Listener,  removeMouseListener, 
removeMouseMotionListener,  removePropertyChangeListener, 
removePropertyChangeListener,  repaint,  repaint,  repaint,  repaint, 
requestFocus,  reshape,  resize,  resize,  setBackground,  setBounds, 
setBounds,  setComponentOrientation,  setDropTarget,  setEnabled, 
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setForeground,  setLocale,  setLocation,  setLocation,  setName,  setSize, 
setSize,  setVisible,  show,  size,  toString,  trans ferFocus 


Methods  inherited  from  class  java.lang.Object 


equals,  getClass,  hashCode,  notify,  notifyAll,  wait,  wait,  wait 


Constructor  Detail 


ModifyPreferences 

public  ModifyPreferences (Java . awt . Frame  parent) 

Constructor. 

Parameters: 

parent  -  the  parent  frame 


Method  Detail 


enablelnput 

public  void  enablelnput ( ) 

Enables  the  GUI  input  elements 


disablelnput 

public  void  disablelnput ( ) 

Disables  the  GUI  input  elements 


savePreferences 

public  void  savePreferences ( ) 

Saves  the  preferences  in  the  file  preferences.txt 
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org.web3d.vrtp.rtp 

Class  RecordTask 

java. lang. Object 
I 
+— org.  web3d.  vrtp.  rtp .  RecordTask 


public  class  RecordTask 
extends  java. lang. Object 
implements  java. lang. Runnable 

A  class  used  by  RtpMonitorManager  objects  to  write  the  statistics  periodically  to  disk.  It  is 
created  as  a  separate  thread  that  waits  for  a  fixed  period  of  time  after  writing  data  to  disk. 

This  class  writes  data  to  the  file  called  "statisticsLastReport.txt",  that  contains  only  the  last 
single  report.  The  FileCatalog  class  is  actually  responsible  for  transferring  the  data  to  the  file 
"statisticsLastFiveMinutes.txt"  and  other  files. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 


Constructor  Summary 


RecordTask (RtpMonitorManager  mon,    double   reclnterval 
Constructor. 


Method  Summary 


void 


exit() 


Resets  a  flag  that  is  checked  each  time  the  thread  associated  with  this  object  is 
awaken  after  the  wait  command,  causing  the  thread  to  end. 


void 


run 


Starts  executing  the  recording  and  waiting  until  the  recording  interval  is  over,  in 
a  loop,  until  the  "exit"  method  is  called. 


Methods  inherited  from  class  java.lang.Object 


equals,    getClass,    hashCode,    notify,    notifyAll,    toString,    wait,    wait,    wait 
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Constructor  Detail 


RecordTask 

public  RecordTask (RtpMonitorManaqer  mon, 

double  reclnterval) 

Constructor.  It  creates  the  session  directory  where  the  stats  files  will  be  written.  Also  it 
creates  a  FileCatalog  object  that  will  organize  the  data  in  several  files  (five  minutes, 
hour  and  day). 
Parameters: 

mon  -  the  RtpMonitorManager  that  manages  the  monitoring  session. 

reclnterval  -  the  interval  between  statistic  samples,  in  seconds. 


Method  Detail 


exit 

public  void  exit ( ) 

Resets  a  flag  that  is  checked  each  time  the  thread  associated  with  this  object  is  awaken 
after  the  wait  command,  causing  the  thread  to  end. 


run 

public  void  run ( ) 

Starts  executing  the  recording  and  waiting  until  the  recording  interval  is  over,  in  a  loop, 
until  the  "exit"  method  is  called. 
Specified  by: 

run  in  interface  java.lang.Runnable 
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org.web3d.vrtp.rtp 

Class  RtpMediaLocator 

j  a va . lang. Object 
I 

+ — javax. media .MediaLocator 
I 
+--org. web3d. vrtp. rtp . RtpMediaLocator 


public  class  RtpMediaLocator 

extends  javax.media.MediaLocator 

A  class  that  represents  necessary  information  to  define  an  RTP  session,  as  address,  port  and 
TTL. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 
See  Also: 

Serialized  Form 


Field  Summary 

static  int 

TTL   UNDEFINED 

Defines  the  value  of  TTL  if  not  provided. 

Constructor  Summary 


R tpMedi aLocator (Java . lang .String  locatorString; 

Constructor. 


Method  Summary 

Java. lang. String 

getSessionAddress ( ) 

Returns  the  RTP  Session  address 

int 

getSessionPort ( ) 

Returns  the  RTP  session  port. 

int 

getTTL ( ) 

Returns  the  session  Time-to-live. 
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Methods  inherited  from  class  javax.media.MediaLocator 


getProtocol,    getRemainder,    getURL,    toExternalForm,    toString 


Methods  inherited  from  class  java.lang.Object 


equals,    getClass,    hashCode,    notify,    notifyAll,    wait,    wait,    wait 


Field  Detail 


TTL_UNDEFINED 

public  static  final  int  TTL_UNDE FINED 

Defines  the  value  of  TTL  if  not  provided. 


Constructor  Detail 


RtpMediaLocator 

public  RtpMediaLocator (java . lang. String   locatorString) 
throws    Java . net . Malf ormedURLException 

Constructor. 
Parameters: 

locatorString  -  Describes  the  session.  It  should  have  the  following  format: 
rtp://address:port[/ttl]  ,  where: 

address  ->  multicast  address  of  the  rtp  session 

port  ->  port  number 

ttl  (optional)  ->  time-to-live 


Method  Detail 


getSessionAddress 

public   java . lang. String   getSessionAddress! 

Returns  the  RTP  Session  address 
Returns: 

String  form  of  the  RTPSession  address 
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getSessionPort 

public  int  getSessionPort ( ) 

Returns  the  RTP  session  port. 
Returns: 

RTP  session  port 


getTTL 

public  int  getTTL ( ) 

Returns  the  session  Time-to-live. 
Returns: 

time-to-live(TTL) 
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org.web3d.vrtp.rtp 

Class  RtpMonitor 

j  ava . lang . Ob j  ect 

+  -- j  ava . awt . Component 
I 

+-- Java . awt . Container 
I 

+-- Java . awt .Window 
I 

+-- Java . awt . Frame 
I 
+--org. web3d. vrtp. rtp. RtpMonitor 

public  class  RtpMonitor 

extends  Java. awt. Frame 

implements  java.awt.event.ActioiiListenerJava.awt.event.ItemListener 

The  RtpMonitor  Application. 

This  class  is  a  frame  that  implements  the  RtpMonitor  GUI. 

If  any  command  line  argument  is  passed  the  RtpMonitorCommandLine  class  is  called  instead. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 
See  Also: 

Serialized  Form 


Fields  inherited  from  class  java.awt.Frame 


CROSSHAIR_CURSOR,  DEFAULT_CURSOR,  E_RESIZE_CURSOR,  HAND_CURSOR,  ICONIFIED, 
MOVE_CURSOR,  N_RESIZE_CURSOR,  NE_RESIZE_CURSOR,  NORMAL,  NW_RESIZE_CURSOR, 
S_RESIZE_CURSOR,  SE_RESIZE_CURSOR,  SW_RESIZE_CURSOR,  TEXT_CURSOR, 
W  RESIZE  CURSOR,  WAIT  CURSOR 


Fields  inherited  from  class  java.awt.Component 


BOTTOM_ALIGNMENT,  CENTER_ALIGNMENT,  LEFT_ALIGNMENT,  RIGHT_ALIGNMENT, 
TOP  ALIGNMENT 
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Constructor  Summary 


RtpMonitor ( ) 

Constructor. 


Method  Summary 


void 


actionPerf ormed ( j ava . awt . event . Act ionEvent  e] 

Takes  action  when  buttons  are  selected. 


boolean 


isMonitoring ( ) 

Returns  the  state  of  RtpMonitor. 


void 


itemS tat eChanged ( j  ava . awt . event . I temEvent    ie] 
Take  action  when  selection  boxes  are  used. 


static   void 


main (Java. lang. String [ ]  args) 

Method  called  upon  executing  class  RtpMonitor. 


void 


showFeedbacks ( ) 

Updates  the  stream  feedbacks. 


void 


showGlobalStats ( 


Updates  the  global  statistics. 


void 


showParticipants ( ) 

Updates  the  lists  of  active  and  passive  participants. 


void 


showS treamS tats 


Updates  the  stream  statistics. 


Methods  inherited  from  class  java.awt.Frame 


addNotify,  getCursorType,  getFrames,  getlconlmage,  getMenuBar,  getState, 
getTitle,  isResizable,  remove,  removeNotif y,  setCursor,  setlconlmage, 
setMenuBar,  setResizable,  setState,  setTitle 


Methods  inherited  from  class  java.awt. Window 


addWindowListener,  applyResourceBundle,  applyResourceBundle,  dispose, 
getFocusOwner,  getlnputContext ,  getLocale,  getOwnedWindows,  getOwner, 
getToolk.it,  getWarningString,  hide,  isShowing,  pack,  postEvent, 
removeWindowListener,  setCursor,  show,  toBack,  toFront 


Methods  inherited  from  class  java.awt.Container 


add,  add,  add,  add,  add,  addContainerListener,  countComponents, 
deliverEvent,  doLayout,  f indComponentAt ,  f indComponentAt ,  getAlignmentX, 
getAlignmentY,  getComponent ,  getComponentAt ,  getComponentAt, 
getComponentCount,  getComponent s,  getlnsets,  getLayout,  getMaximumSize, 
getMinimumSize,  getPref erredSize,  insets,  invalidate,  isAncestorOf , 
layout,  list,  list,  locate,  minimumSize,  paint,  paintComponents, 
preferredSize,  print,  printComponents,  remove,  remove,  removeAll, 
removeContainerListener,  setFont,  setLayout,  update,  validate 
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Methods  inherited  from  class  java.awt.Component 


action,  add,  addComponentListener,  addFocusListener, 
addlnputMethodListener,  addKeyListener,  addMouseListener, 
addMouseMotionListener,  addPropertyChangeListener, 

addPropertyChangeListener,  bounds,  checklmage,  checklmage,  contains, 
contains,  createlmage,  createlmage,  disable,  dispatchEvent ,  enable, 
enable,  enablelnputMethods,  getBackground,  getBounds,  getBounds, 
getColorModel,  getComponentOrientation,  getCursor,  getDropTarget ,  getFont, 
getFontMetrics,  getForeground,  getGraphics,  getHeight, 

getlnputMethodRequests,  getLocation,  getLocation,  getLocationOnScreen, 
getName,  getParent,  getPeer,  getSize,  getSize,  getTreeLock,  getWidth, 
getX,  getY,  gotFocus,  handleEvent,  hasFocus,  imageUpdate,  inside, 
isDisplayable,  isDoubleBuf fered,  isEnabled,  isFocusTraversable, 
isLightweight ,  isOpaque,  isValid,  isVisible,  keyDown,  keyUp,  list,  list, 
list,  location,  lostFocus,  mouseDown,  mouseDrag,  mouseEnter,  mouseExit, 
mouseMove,  mouseUp,  move,  nextFocus,  paintAll,  preparelmage,  preparelmage, 
printAll,  removeComponentListener,  removeFocusListener, 
removelnputMethodListener,  removeKeyListener,  removeMouse Listener, 
removeMouseMotionListener,  removePropertyChangeListener, 
removePropertyChangeListener,  repaint,  repaint,  repaint,  repaint, 
requestFocus,  reshape,  resize,  resize,  setBackground,  setBounds, 
setBounds,  setComponentOrientation,  setDropTarget ,  setEnabled, 
setForeground,  setLocale,  setLocation,  setLocation,  setName,  setSize, 
setSize,  setVisible,  show,  size,  toString,  transferFocus 


Methods  inherited  from  class  java.lang.Object 


equals,  getClass,  hashCode,  notify,  notifyAll,  wait,  wait,  wait 


Constructor  Detail 


RtpMonitor 

public   RtpMonitor ( ) 

Constructor.  It  is  called  by  main()  if  no  command  line  argument  is  passed. 
The  constructor  initializes  the  GUI  components. 


Method  Detail 


actionPerformed 

public  void  actionPerformed ( Java . awt . event .Act ionE vent  e) 

Takes  action  when  buttons  are  selected. 
Specified  by: 

actionPerformed  in  interface  java.awt.event.ActionListener 
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showGlobalStats 

public  void  showGlobalStats ( ) 

Updates  the  global  statistics. 


showParticipants 

public  void  showParticipants ( ) 

Updates  the  lists  of  active  and  passive  participants. 


showStreamStats 

public  void  showStreamStats ( ) 

Updates  the  stream  statistics. 


showFeedbacks 

public  void  showFeedbacks ( ) 

Updates  the  stream  feedbacks. 


itemStateChanged 

public  void  itemStateChanged ( Java . awt . event . ItemEvent  ie) 

Take  action  when  selection  boxes  are  used. 
Specified  by: 

itemStateChanged  in  interface  java.awt.event.ItemListener 

isMonitoring 

public  boolean  isMonitoring ( ) 

Returns  the  state  of  RtpMonitor.  Also  exits  the  program  if  the  duration  is  over. 
Returns: 

true  if  the  monitor  is  active 
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main 

public    static   void  main (Java . lang. String [ ]    args) 

Method  called  upon  executing  class  RtpMonitor.  If  there  is  no  argument  an  object  of 
class  RtpMonitor  will  be  instantiated  and  executed,  otherwise  the  same  will  happen 
with  an  RtpMonitorCommandLine  object. 
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org.web3d.vrtp.rtp 

Class  RtpMonitorCommandLine 

j  ava . lang . Ob j  ect 
I 
+--org. web3d. vrtp . rtp. RtpMonitorCommandLine 


public  class  RtpMonitorCommandLine 

extends  java.lang.  Object 

A  class  used  to  start  a  RTP  monitor  from  command  line  inputs. 
This  monitor  does  not  have  the  option  of  playing  streams. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 


Constructor  Summary 


RtpMonitorCommandLine ( j  ava . lanq . String [ ]  arqs. 

Constructor. 


Method  Summary 


static  void 


main (Java . lang. String [ ]    args. 


Method  called  upon  executing  class  RtpMonitorCommandLine. 


void 


run( ) 


Method  that  will  create  the  RtpMonitorManager  object  and  will  exit  the 
program  when  the  user  defined  duration  is  elapsed. 


Methods  inherited  from  class  java.lang.Object 


equals,    getClass,    hashCode,    notify,    notifyAll,    toString,    wait,    wait,    wait 


Constructor  Detail 


RtpMonitorCommandLine 
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public  RtpMonitorCommandLine ( j ava . lang. String [ ]  args) 

Constructor.  It  reads  the  command  line  arguments  and  sets  variables  and  flags.  The 
command  line  arguments  have  the  following  format: 

Java  RtpMonitorCommandLine  rtpLocator  [options] 

rtpLocator  example:  rtp://224.2. 125.50:50328/1 27 

-part :  monitor  sends  RTCP  packets 

-play  :  monitor  play  streams 

-record  :  monitor  records  statistics 

-i  nnn  :  nnn  defines  the  recording  interval  in  seconds  (default  30s) 

-e  ppp  :  ppp  defines  the  monitoring  duration  in  hours  (default:  1 68  hs) 

-help  :  displays  command  line  format  and  aborts 

Parameters: 

args  -  an  array  of  strings 


Method  Detail 


main 

public  static  void  main (Java . lang. String [ ]  args) 

Method  called  upon  executing  class  RtpMonitorCommandLine. 
run 

public    void   run ( ) 

Method  that  will  create  the  RtpMonitorManager  object  and  will  exit  the  program  when 
the  user  defined  duration  is  elapsed. 
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org.web3d.vrtp.rtp 

Class  RtpMonitorManager 

j  ava . lang . Ob j  ect 
I 
+--org. web3d. vrtp. rtp. RtpMonitorManager 


public  class  RtpMonitorManager 

extends  Java. lang. Object 

implements  javax.media.rtp.ReceiveStreamListener 

A  class  that  encapsulates  all  operations  necessary  to  start  a  new  monitoring  session,  play  its 
streams,  and  record  statistical  data. 

This  class  does  not  display  statistics  on  screen.  That  must  be  done  by  another  class,  usually  a 
frame,  using  data  from  a  SessionManager  object  (  see  method  getSessionManager  ). 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 


Constructor  Summary 


RtpMonitorManager (Java. lang. String  locatorString,  boolean  willParticipate, 
boolean  willPlayStreams,  boolean  willRecord,  double  recordlnterval) 


Method  Summary 

void 

close ( ) 

Closes  a  monitor  session,  stops  recording  and  closes 
player  windows 

RtpMediaLocator 

getMediaLocator ( ) 

Returns  the  RtpMediaLocator  associated  with  the  RTP 
session 

javax. media . rtp . SessionAddress 

getSessionAddress ( ) 

Returns  the  SessionAddress  object  associated  with  the 
RTP  session 
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javax .media . rtp . SessionManager 


getSessionManager ( ) 

Returns  the  SessionManager  object  created  by  the 
monitor 


void 


update 

(javax. media . rtp . event . ReceiveStreamEvent    event; 

Method  of  classes  that  implement  the 
Receive  StreamListener  interface 


Methods  inherited  from  class  java.lang.Object 


equals,    getClass,    hashCode,    notify,    notifyAll,    toString,    wait,    wait,    wait 


Constructor  Detail 


RtpMonitorManager 

public   RtpMonitorManager (Java . lang. String    locatorString, 

boolean   willParticipate, 
boolean   willPlayStreams, 
boolean   willRecord, 
double   recordlnterval) 
throws    Java. net . Malf ormedURLException, 
j  ava . net . UnknownHostException, 
javax. media. rtp . SessionManager Except ion, 
j  ava . io . IOException 

Parameters: 

locatorString  -  the  session  description  string  format,  e.g. 
rtp://224.2. 1 34.67:50980/1 27 

willParticipate  -  true  if  the  Monitor  will  participate  in  the  session,  sending 
RTCP  packets,  false  otherwise. 

willPlayStreams  -  true  if  the  Monitor  will  play  the  receiving  streams,  false 
otherwise. 

willRecord  -  true  if  the  Monitor  will  record  statistical  data  about  the  session, 
false  otherwise. 

recordlnterval  -  the  time  between  data  recordings  in  seconds 
Throws: 

java.net.MalformedURLException  -  if  the  locatorString  argument  does  not 
conform  to  the  syntax. 

java.net.UnknownHostException  -  if  InetAddress.getByName(session  address) 
fails 

javax.media.rtp.SessionManagerException  -  Exception  thrown  when  there  is  an 
error  starting  an  RTPSessionManager 
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java.io.IOException  -  Exception  thrown  when  there  is  an  error  in 
RTPSessionManager 


Method  Detail 


update 

public   void  update (j avax .media . rtp. event . ReceiveStreamEvent    event; 

Method  of  classes  that  implement  the  ReceiveStreamListener  interface 
Specified  by: 

update  in  interface  javax.media.rtp.ReceiveStreamListener 

close 

public   void   close ( ) 

Closes  a  monitor  session,  stops  recording  and  closes  player  windows 

getMediaLocator 

public  RtpMediaLocator  getMediaLocator ( ) 

Returns  the  RtpMediaLocator  associated  with  the  RTP  session 
Returns: 

the  session  media  locator 

getSessionManager 

public    j avax. media . rtp. SessionManager   getSessionManager ( ) 

Returns  the  SessionManager  object  created  by  the  monitor 
Returns: 

the  SessionManager  (RTPSessionMgr) 

getSessionAddress 

public  j avax. media. rtp. SessionAddress  getSessionAddress ( ) 

Returns  the  SessionAddress  object  associated  with  the  RTP  session 
Returns: 

the  SessionAddress 
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org.web3d.vrtp.rtp 

Class  RtpPlayerWindow 

Java . lang. Object 
I 

+  -- j  ava . awt . Component 
I 

+--java . awt . Container 
I 

+  -- j  ava . awt .Window 
I 

+  -- j  ava . awt . Frame 
I 


+--com. sun. media . ui . PlayerWindow 
I 
+--org . web3d . vrtp . rtp . RtpPlayerWindow 


public  class  RtpPlayerWindow 

extends  com.sun.media.ui.Player Window 

This  class  is  used  to  create  a  window  for  playing  an  audio/video  stream.  It  is  a  subclass  of 
PlayerWindow,  that  added  the  capacity  of  modifying  the  window  name.  Both  classes  were 
developed  by  SUN.  RTPPlayer Window  came  with  JMF1.1  sample  code  and  PlayerWindow  is 
in  the  file  JMF.jar. 

See  Also: 

Serialized  Form 


Fields  inherited  from  class  java.awt.Frame 


CROSSHAIR_CURSOR,  DEFAULT_CURSOR,  E_RESIZE_CURSOR,  HAND_CURSOR,  ICONIFIED, 
MOVE_CURSOR,  N_RESIZE_CURSOR,  NE_RESIZE_CURSOR,  NORMAL,  NW_RESIZE_CURSOR, 
5_RESIZE_CURS0R,  SE_RESIZE_CURSOR,  SW_RESIZE_CURSOR,  TEXT_CURSOR, 
W  RESIZE  CURSOR,  WAIT  CURSOR 


Fields  inherited  from  class  java.awt.Component 


BOTTOM_ALIGNMENT,  CENTER_ALIGNMENT,  LEFT_ALIGNMENT,  RIGHT_ALIGNMENT, 
TOP  ALIGNMENT 


Constructor  Summary 

RtpPlayerWindow ( j  avax . media . Pie 

lyer 

pic 

lyer, 

Java 

.  lang 

String 

title) 
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Method  Summary 


void  Name  (  java  .  lang.  String  title! 


Methods  inherited  from  class  com.sun.media.ui.PlayerWindow 


addNotify,  controllerUpdate,  doResize,  killThePlayer,  zoomTo 


Methods  inherited  from  class  java.awt.Frame 


getCursorType,  getFrames,  getlconlmage,  getMenuBar,  getState,  getTitle, 
isResizable,  remove,  removeNotif y,  setCursor,  setlconlmage,  setMenuBar, 
setResizable,  setState,  setTitle 


Methods  inherited  from  class  java.awt.Window 


addWindowListener,  applyResourceBundle,  applyResourceBundle,  dispose, 
getFocusOwner,  getlnputContext ,  getLocale,  getOwnedWindows,  getOwner, 
getToolkit,  getWarningString,  hide,  isShowing,  pack,  postEvent, 
removeWindowListener,  setCursor,  show,  toBack,  toFront 


Methods  inherited  from  class  java.awt.Container 


add,  add,  add,  add,  add,  addContainerListener,  countComponents, 
deliverEvent,  doLayout,  f indComponentAt,  f indComponentAt,  getAlignmentX, 
getAlignmentY,  getComponent,  getComponentAt ,  getComponentAt , 
getComponentCount ,  getComponents,  getlnsets,  getLayout,  getMaximumSize, 
getMinimumSize,  getPref erredSize,  insets,  invalidate,  isAncestorOf , 
layout,  list,  list,  locate,  minimumSize,  paint,  paintComponents, 
preferredSize,  print,  printComponents,  remove,  remove,  removeAll, 
removeContainerListener,  setFont,  setLayout,  update,  validate 


Methods  inherited  from  class  java.awt.Component 


action,  add,  addComponentListener,  addFocusListener, 
addlnputMethodListener,  addKeyListener,  addMouseListener, 
addMouseMotionListener,  addPropertyChangeListener, 

addPropertyChangeListener,  bounds,  checklmage,  checklmage,  contains, 
contains,  createlmage,  createlmage,  disable,  dispatchEvent,  enable, 
enable,  enablelnputMethods,  getBackground,  getBounds,  getBounds, 
getColorModel,  getComponentOrientation,  getCursor,  getDropTarget,  getFont, 
getFontMetrics,  getForeground,  getGraphics,  getHeight, 

getlnputMethodRequests,  getLocation,  getLocation,  getLocationOnScreen, 
getName,  getParent,  getPeer,  getSize,  getSize,  getTreeLock,  getWidth, 
getX,  getY,  gotFocus,  handleEvent,  hasFocus,  imageUpdate,  inside, 
isDisplayable,  isDoubleBuf f ered,  isEnabled,  isFocusTraversable, 
isLightweight,  isOpaque,  isValid,  isVisible,  keyDown,  keyUp,  list,  list, 
list,  location,  lostFocus,  mouseDown,  mouseDrag,  mouseEnter,  mouseExit, 
mouseMove,  mouseUp,  move,  nextFocus,  paintAll,  preparelmage,  preparelmage, 
printAll,  removeComponentListener,  removeFocusListener, 
r emo ve Input Me thodListener,  removeKeyListener,  removeMouseListener, 
removeMouseMotionListener,  r emo vePropertyChange Listener, 
removePropertyChangeListener,  repaint,  repaint,  repaint,  repaint, 
requestFocus,  reshape,  resize,  resize,  setBackground,  setBounds, 
setBounds,  setComponentOrientation,  setDropTarget,  setEnabled, 
setForeground,  setLocale,  setLocation,  setLocation,  setName,  setSize, 
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setSize,  setVisible,  show,  size,  toString,  transferFocus 


Methods  inherited  from  class  java.lang.Object 


equals,  getClass,  hashCode,  notify,  notifyAll,  wait,  wait,  wait 


Constructor  Detail 


RtpPlayerWindow 

public  RtpPlayerWindow ( j avax . media. Player  player, 

Java . lang. String  title) 


Method  Detail 


Name 


public  void  Name (Java . lang. String  title] 


Class  Tree  Deprecated  Index  Help 

PREV  CLASS    NEXT  CLASS 

SUMMARY:   INNER  |  FIELD  I  CONSTR  |  METHOD 


FRAMES     NO  FRAMES 

DETAIL:  FIELD  I  CONSTR  I  METHOD 


130 


Class  Tree  Deprecated  Index  Help 

PREV  CLASS    NEXT  CLASS 

SUMMARY:   INNER  |  FIELD  I  CONSTR  [  METHOD 


FRAMES     NO  FRAMES 

DETAIL:   FIELD  |  CONSTR  |  METHOD 


org.web3d.vrtp.rtp 

Class  RtpUtil 

java. lang. Object 
I 
+--org. web3d. vrtp. rtp. RtpUtil 


public  class  RtpUtil 
extends  java. lang. Object 

A  class  with  some  RTP  utilities  (static  methods) 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 


Constructor  Summary 


RtpUtil ( ) 


Method  Summary 

static   long 

correctSSRC (long   ssrc) 

Converts  an  number  represented  as  a  signed  integer(32  bits)  to 
a  long  integer  (64  bits). 

static   java. lang. String 

getUsername (javax. media . rtp. Participant   part) 
Returns  the  participant  username 

static   java . lang. String 

getUsernameOrCNAME (javax .media . rtp. Participant   part) 

Returns  the  participant's  username  or  his  CNAME,  if  no 
username  is  known. 

Methods  inherited  from  class  java.lang.Object 


equals,    getClass,    hashCode,    notify,    notifyAll,    toString,    wait,    wait,    wait 


Constructor  Detail 
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RtpUtil 

public  RtpUtil 


Method  Detail 


getUsername 

public   static   Java . lang. String   getUsername (javax. media . rtp . Participant   part) 

Returns  the  participant  username 
Parameters: 

part  -  the  Participant  object 
Returns: 

a  string  with  the  participant's  username 

getUsernameOrCNAME 

public   static   Java . lang. String   getUsernameOrCNAME (javax. media . rtp. Participant 

Returns  the  participant's  username  or  his  CNAME,  if  no  username  is  known. 
Parameters: 

part  -  the  Participant  object 
Returns: 

a  string  with  the  participant's  username  or  CNAME 

correctSSRC 

public    static   long   correctSSRC (long   ssrc) 

Converts  an  number  represented  as  a  signed  integer(32  bits)  to  a  long  integer  (64  bits). 
JMF  methods  return  the  SSRC  as  an  integer.  As  the  SSRC  is  a  32  bits  number,  some 
are  represented  in  JMF  as  negative  integers.  This  convertion  is  necessary  to  present 
SSRCs  as  a  positive  integer. 

Class  Tree  Deprecated  Index  Help 

PREV  CLASS    NEXT  CLASS  FRAMES     NO  FRAMES 

SUMMARY:   INNER  I  FIELD  I  CQNSTR  |  METHOD  DETAIL:   FIELD  I  CQNSTR  |  METHOD 
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Class  Tree  Deprecated  Index  Help 

PREV  CLASS    NEXT  CLASS  FRAMES     NO  FRAMES 

SUMMARY:   INNER  |  FIELD  |  CONSTR  |  METHOD  DETAIL:   FIELD  |  CONSTR  |  METHOD 


org.web3d.vrtp.rtp 

Class  SelectBookmark 

j  ava . lang . Ob j  ect 
I 

+  -- j  ava . awt . Component 
I 

+-- java . awt . Container 
I 

+-- Java . awt .Window 
I 

+--java . awt .Dialog 
I 
+--org. web3d. vrtp. rtp. SelectBookmark 


public  class  SelectBookmark 

extends  java.awt.Dialog 

implements  java.awt.event.ItemListener 

A  Dialog  to  select  a  session  bookmark.  It  displays  a  list  choice  of  session  names. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 
See  Also: 

Serialized  Form 


Fields  inherited  from  class  java.awt.Component 


BOTTOM_ALIGNMENT,  CENTER_ALIGNMENT,  LEFT_ALIGNMENT,  RIGHT_ALIGNMENT, 
TOP  ALIGNMENT 


Constructor  Summary 


SelectBookmark ( j ava . awt . Frame  parent ) 


Constructor. 


Method  Summary 


void 


itemStateChanged( Java . awt . event . ItemEvent    e' 
Activated  when  a  bookmark  choice  is  made. 
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Methods  inherited  from  class  java.awt.Dialog 


addNotify,  dispose,  getTitle,  hide,  isModal,  isResizable,  setModal, 
setResizable,  setTitle,  show 


Methods  inherited  from  class  java.awt.Window 


addWindowListener,  applyResourceBundle,  applyResourceBundle, 
getFocusOwner,  getlnputContext ,  getLocale,  getOwnedWindows,  getOwner, 
getToolkit,  getWarningString,  isShowing,  pack,  postEvent, 
removeWindowListener,  setCursor,  toBack,  toFront 


Methods  inherited  from  class  java.awt.Container 


add,  add,  add,  add,  add,  addContainerListener,  countComponents, 
deliverEvent,  doLayout,  f indComponentAt,  f indComponentAt ,  getAlignmentX, 
getAlignmentY,  getComponent ,  getComponentAt,  getComponentAt, 
getComponentCount,  getComponents,  getlnsets,  getLayout,  getMaximumSize, 
getMinimumSize,  getPreferredSize,  insets,  invalidate,  isAncestorOf , 
layout,  list,  list,  locate,  minimumSize,  paint,  paintComponents, 
preferredSize,  print,  printComponents,  remove,  remove,  removeAll, 
removeContainerListener,  removeNotif y,  setFont,  setLayout,  update, 
validate  • 


Methods  inherited  from  class  java.awt.Component 


action,  add,  addComponentListener,  addFocusListener, 
addlnputMethodListener,  addKeyListener,  addMouseListener, 
addMouseMotionListener,  addPropertyChangeListener, 

addPropertyChangeListener,  bounds,  checklmage,  checklmage,  contains, 
contains,  createlmage,  createlmage,  disable,  dispatchEvent ,  enable, 
enable,  enablelnputMethods,  getBackground,  getBounds,  getBounds, 
getColorModel,  getComponentOrientation,  getCursor,  getDropTarget ,  getFont, 
getFontMetrics,  getForeground,  getGraphics,  getHeight, 

getlnputMethodRequests,  getLocation,  getLocation,  getLocationOnScreen, 
getName,  getParent,  getPeer,  getSize,  getSize,  getTreeLock,  getWidth, 
getX,  getY,  gotFocus,  handleEvent,  hasFocus,  imageUpdate,  inside, 
isDisplayable,  isDoubleBuf f ered,  isEnabled,  isFocusTraversable, 
isLightweight,  isOpaque,  isValid,  isVisible,  keyDown,  keyUp,  list,  list, 
list,  location,  lostFocus,  mouseDown,  mouseDrag,  mouseEnter,  mouseExit, 
mouseMove,  mouseUp,  move,  nextFocus,  paintAll,  preparelmage,  preparelmage, 
printAll,  remove,  removeComponentListener,  removeFocusListener, 
r emove Input Me thodListener,  removeKeyListener,  removeMouseListener, 
removeMouseMotionListener,  removePropertyChangeListener, 
removePropertyChangeListener,  repaint,  repaint,  repaint,  repaint, 
requestFocus,  reshape,  resize,  resize,  setBackground,  setBounds, 
setBounds,  setComponentOrientation,  setDropTarget ,  setEnabled, 
setForeground,  setLocale,  setLocation,  setLocation,  setName,  setSize, 
setSize,  setVisible,  show,  size,  toString,  transferFocus 


Methods  inherited  from  class  java.lang.Object 


equals,  getClass,  hashCode,  notify,  notifyAll,  wait,  wait,  wait 


Constructor  Detail 
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Select  Bookmark 

public    SelectBookmark ( Java . awt . Frame    parent; 
Constructor. 

Parameters: 

parent  -  the  parent  frame 


Method  Detail 


itemStateChanged 

public  void  itemStateChanged ( j ava . awt . event . I temEvent  e) 

Activated  when  a  bookmark  choice  is  made. 

Specified  by: 

itemStateChanged  in  interface  java.awt.event.ItemListener 
Parameters: 

parent  -  the  parent  frame 

Class  Tree  Deprecated  Index  Help 

PREV  CLASS    NEXT  CLASS  FRAMES     NO  FRAMES 

SUMMARY:   INNER  |  FIELD  I  CONSTR  |  METHOD  DETAIL:   FIELD  I  CQNSTR  I  METHOD 
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APPENDIX  D.  RTPMONITOR  SOURCE  CODE 

package  org. web3d. vrtp. rtp; 

import  java . awt . *; 
import  Java . awt . event . * ; 
import  java.util.*; 

*  A  Dialog  to  display  information  about  the  program 

*  e.g.  version,  date 

*  <p> 
* 

*  @author      Francisco  Afonso    (afonso@cs.nps.navy.mil) 

*  (Aversion    1.0 

*/ 

public  class  About  extends  Dialog  { 

*  Constructor. 

*  <P> 

*  @param  parent  the  parent  frame 
*/ 

public  About (Frame  parent)! 

super (  parent,  "About"  ,  true  ); 
setSize(  270  ,  200  ) ; 
setLayout (null) ; 
setBackground (Color. lightGray)  ; 

addWindowListener (  new  CloseWindow ( )  ); 

Label  versionLabel  =  new  Label (  "rtpMonitor  version  1.0"); 
versionLabel . setBounds (  20,  30,  150,  25  ) ; 
add (versionLabel) ; 

Label  versionDateLabel  =  new  Label (  "Version  date:  30  August  1999"); 
versionDateLabel. setBounds (  20,  60,  180,  25  ); 
add (versionDateLabel ) ; 

Label  npsLabel  =  new  Label (  "Naval  Postgraduate  School"); 
npsLabel. setBounds (  20,  90,  150,  25  ); 
add (npsLabel) ; 

Label  vrtpLabel  =  new  Label (  "virtual  reality  transfer  protocol  (vrtp)"); 
vrtpLabel. setBounds (  20,  120,  200,  25  ); 
add (vrtpLabel) ; 

Label  siteLabel  =  new  Label (  "http://www.web3d.org/WorkingGroups/vrtp/"); 
siteLabel. setBounds (  20,  150,  240,  25  ); 
add (siteLabel) ; 
} 

}  //  end  of  class  About 
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package  org. web3d. vrtp. rtp; 

import  java.awt.*; 
import  java . awt . event . * ; 
import  Java. util . * ; 
import  java.io.*; 

/** 

*  The  Dialog  to  add  a  session  bookmark. 

*  <P> 
■*■ 

*  Sauthor   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  @version  1 . 0 
*/ 

public  class  AddBookmark  extends  Dialog 

implements  ActionListener { 

Vector  sessionAddressVec,  sessionNamesVec; 

Label  sessionAddLabel,  sessionAddRealLabel,  sessionNameLabel; 

TextField  sessionNameText; 

Button  addButton,  cancelButton; 

RtpMonitor  theParent; 


/  -k-k 

*  Constructor. 

*  <P> 

*  @param  parent  the  parent  frame 
*/ 

public  AddBookmark (Frame  parent)! 

super (  parent,  "Add  Bookmark"  ,  true  )  ; 

setSize(  350  ,  170  )  ; 

setLayout  (null)  ; 

setBackground (Color. lightGray)  ; 

addWindowListener (  new  CloseWindow ( )  ); 

theParent  =  (RtpMonitor)  parent; 

loadBookmarks ( ) ; 

sessionAddLabel  =  new  Label (  "Session  Address:"); 
sessionAddLabel. setBounds (  10,  40,  100,  25  ); 
add (sessionAddLabel)  ; 

sessionAddRealLabel  =  new  Label (  theParent . sessionText . getText ()) ; 
sessionAddRealLabel . setBounds ( 115, 40,  230,  25  ); 
add (sessionAddRealLabel ) ; 

sessionNameLabel  =  new  Label (  "Session  Name"); 
sessionNameLabel . setBounds (  10,  80,  100,  25  ); 
add (sessionNameLabel)  ; 

sessionNameText  =  new  TextField (theParent . sessionNameText . getText ()) ; 
sessionNameText . setBounds ( 110,  80,  230,  25); 
add (sessionNameText)  ; 
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addButton  =  new  Button ( "Add" ) ; 
addButton. setBounds (100, 130, 60, 25) ; 
addButton. addActionListener (this) ; 
add (addButton) ; 

cancelButton  =  new  Button ( "Cancel" ) ; 
cancelButton. setBounds (200, 130, 60,  25) 
cancelButton . addActionListener ( this ) ; 
add (cancelButton) ; 


/  +  * 

*   Takes  action  when  buttons  are  selected. 
+ 

*/ 

public  void  actionPerf ormed (  ActionEvent  e  ) 
{ 

if(  e.getSource ( )  ==  addButton) { 

String  sessAdd   =  theParent . sessionText . getText (). trim () ; 
String  sessName  =  sessionNameText . getText (). trim () ; 
if (  ! sessName . equals ("" )  ){ 

sessionNamesVec . addElement (sessName) ; 
sessionAddressVec . addElement (sessAdd) ; 
saveBookmarks ( ) ; 

theParent . sessionNameText . setText (  sessName  ) ; 
setVisible ( false) ; 
} 
} 

if(  e. getSource ( )  ==  cancelButton) { 

setVisible (false) ; 
} 


*  Loads  the  session  bookmarks  from  file  "bookmarks.txt" 
*/ 
private  void  loadBookmarks ( ) { 

sessionAddressVec  =  new  Vector () ; 
sessionNamesVec  =  new  Vector () ; 


try{ 

Buf feredReader  input  =  new  Buf feredReader (  new 

FileReader ("bookmarks.txt")  ); 
String  line; 

while (  (line  =  input . readLine () )  !=  null){ 
int  pos  =  line.lastlndexOf ("rtp: //") ; 
if  (pos  !=  -1) { 

sessionAddressVec. addElement (  line . substring (pos ). trim ( )  ) ; 

sessionNamesVec. addElement (  line . substring (  0  ,  pos  ).trim() 
} 
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} 

input . close ( ) ; 
} 
catch  (  FileNotFoundException  e) { 

System. out . println  (  "Add  Bookmarks:  "  +  e . getMessage ( )  ) ; 
} 
catch  (  IOException  e) { 

System. err .println (  "Exception  reading  bookmark:  "  +  e . getMessage ( )  ) ; 
} 


} 


/** 

*  Saves  the  session  bookmarks  to  file  "bookmarks.txt" 
*/ 

private  void  saveBookmarks ( ) { 
PrintStream  output; 

try  { 

output  =  new  PrintStream  (new  FileOutputStreamCbookmarks.txt",  false)  ); 

for(int  ii=0;  ii  <  sessionAddressVec. size ( ) ;  ++ii){ 

output .print (  (String)  sessionNamesVec. elementAt (ii) ) ; 

output. print  (  "  "  ) ; 

output .println (  (String)  sessionAddressVec. elementAt (ii)  ); 

} 

output . close  ( ) ; 
} 
catch  (FileNotFoundException  e) { 

System. out .println (  "Saving  bookmarks  :  "  +  e . getMessage ( )  ) ; 

} 

catch  (  IOException  e) { 

System. err .println (  "Exception  writing  bookmark:  "  +  e . getMessage ( )  ); 
} 


} 
}  //  end  of  class  AddBookmark 
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package  org . web3d. vrtp . rtp; 

import  java . awt . event . * ; 

/** 

*  This  class  is  used  to  set  a  frame/dialog  as  not  visible 

*  when  the  close  icon  is  clicked. 

*  @author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  (aversion  1.0 
*/ 

public  class  CloseWindow  extends  WindowAdapter  { 

/*  * 

*  set  frame/dialog  as  not  visible.  This  method  is  activated  when  the  window 

*  is  closed. 

* 

public  void  windowClosing (  WindowEvent  e  ) 
{ 

e . getWindow ( ) . setVisible (  false  ); 

} 

}  //  end  of  class  CloseWindow 
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package  org. web3d. vrtp. rtp; 

import  java. awt.*; 
import  Java. awt . event . *; 
import  Java . util . * ; 
import  java.io.*; 

/** 

*  A  Dialog  to  delete  a  session  bookmark. 

*  <P> 
■*■ 

*  ©author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  @version  1.0 
*/ 

public  class  DeleteBookmark  extends  Dialog 

implements  ActionListener { 

java . awt . List  sessionNamesList; 

Vector  sessionAddressVec; 

Button  deleteButton,  cancelButton; 

/** 

*  Constructor. 

*  <P> 

*  @param  parent  the  parent  frame 
*/ 

public  DeleteBookmark (Frame  parent) { 

super  (  parent,  "Delete  Bookmark"  ,  true  ); 

setSize(  250  ,  300  ) ; 

setLayout (null) ; 

setBackground (Color . lightGray ) ; 

addWindowListener (  new  CloseWindow ( )  ); 

sessionNamesList  =  new  java . awt . List (  5  ,  false); 
sessionNamesList . set Bounds (10, 30, 230, 210); 

loadBookmarks ( ) ; 

add (sessionNamesList ) ; 

deleteButton  =  new  Button ( "Delete" ) ; 
deleteButton. setBounds (50, 260, 60, 25) ; 
deleteButton. addActionListener (this) ; 
add (deleteButton) ; 

cancelButton  =  new  Button ( "Cancel" ) ; 
cancelButton. setBounds (130, 260, 60, 25) ; 
cancelButton. addActionListener (this) ; 
add (cancelButton) ; 
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/  *  + 

*  Takes  action  when  buttons  are  selected. 
* 

*/ 

public  void  actionPerformed (  ActionEvent  e  ) 
{ 

if (  e . getSource ( )  ==  deleteButton) { 

int  index  =  sessionNamesList . getSelectedlndex 
if (  index  >=  0  ) { 

sessionNamesList . remove (index) ; 
sessionAddressVec . remove (index) ; 
saveBookmarks ( ) ; 
} 
} 

if(  e . getSource ( )  ==  cancelButton) { 

setVisible (false)  ; 
} 


*  Loads  the  session  bookmarks  from  file  "bookmarks.txt" 
*/ 
private  void  loadBookmarks ( ) { 

sessionAddressVec  =  new  Vector () ; 

try{ 

Buf f eredReader  input  =  new  Buf feredReader (  new 

FileReader ("bookmarks.txt")  ); 
String  line; 

while (  (line  =  input . readLine () )  !=  null){ 
int  pos  =  line. lastlndexOf ("rtp: //") ; 
if  (pos  !=  -1)  { 

sessionAddressVec . addElement (  line . substring (pos) . trim ( )  ) ; 
sessionNamesList . add (  line . substring (  0  ,  pos  ).trim()  ) ; 
} 
} 
input . close ( ) ; 

} 

catch  (  FileNotFoundException  e) { 

System. out .println (  "Delete  Bookmarks:  "  +  e . getMessage ( )  ) ; 
} 
catch  (  IOException  e) { 

System. err .println (  "Exception  reading  bookmark:  "  +  e . getMessage ( ) 
} 
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*  Saves  the  session  bookmarks  to  file  "bookmarks.txt" 
*/ 

private  void  saveBookmarks ( ) { 
PrintStream  output; 

try  { 

output  =  new  PrintStream (new  FileOutputStream ( "bookmarks . txt",  false)  ); 

for(int  ii=0;  ii  <  sessionAddressVec. size ( ) ;  ++ii) { 

output .print (  sessionNamesList . get It em (ii) ) ; 

output. print (  "  "  ); 

output . println (  (String)  sessionAddressVec . elementAt (ii)  ); 
} 

output . close ( ) ; 

} 

catch  (FileNotFoundException  e){ 

System. out .println (  "Saving  bookmarks  :  "  +  e . getMessage ( )  ) ; 
} 
catch  (  IOException  e) { 

System. err .println (  "Exception  writing  bookmark:  "  +  e . getMessage ( )  ); 
} 


} 
}  //  end  of  class  DeleteBookmark 
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package  org. web3d. vrtp. rtp; 

import  j avax. media . rtp. *; 
import  j avax. media . rtp. event . * ; 
import  j avax. media . rtp. rtcp. *; 

import  java.awt.*; 
import  Java . util . *; 

*  A   class  used  by  RtpMonitor  objects  to  periodically  launch  their  showStats 

*  methods  (screen  updates). 

*  <P> 

*  @author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  @version  1.0 
*/ 

public  class  DisplayTask  implements  Runnable  { 

RtpMonitor  myMon; 
SessionManager  mymgr; 
Thread  thread; 
int  intervalParam; 

/■*■  * 

*  Constructor.  It  creates  a  new  thread  of  execution  and  calls 

*  the  method  run ( ) . 
* 

*  @param  mon  the  RtpMonitor  object  that  will  be  called  back  for  screen 

*  updates . 

*  @param  interval  the  interval  between  screen  data  updates,  in  seconds. 
*/ 

public  DisplayTask (RtpMonitor  mon,  double  interval) { 

myMon  =  mon; 

intervalParam  =  (int)  (interval*1000) ; 

thread  =  new  Thread (this, "DisplayTask  thread"); 
thread. setDaemon (true) ; 
thread. start ( ) ; 
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*  This  method  runs  continuously  calling  the  showStats  methods  of  RtpMonitor 

*  in  the  proper  presentation  interval,  until  the  RtpMonitor  stops  the 

*  session. 
*/ 

public  void  run  ( ) { 

while (myMon . isMonitoring ( ) ) { 

myMon . showGlobalStats ( )  ; 
myMon . showParticipants ( )  ; 
myMon . showStreamStats ( )  ; 
myMon . showFeedbacks ( )  ; 

try{ 

Thread. sleep (intervalParam) ; 

} 

catch  (InterruptedException  e) { } 

} 
} 

}  //  end  of  class  DisplayTask 


146 


package  org. web3d. vrtp. rtp; 

import  java.io.*; 
import  Java . util . * ; 

/*  ■*• 

*  A  class  used  by  RecordTask  objects  to  organize  statistics 

*  in  several  files  (  five  minutes,  hour,  and  day  )  . 

*  <P> 

*  This  class  writes  to  the  file  following  files: 

*  statistics Las tFiveMinutes . txt,  statisticsPreviousFiveMinutes . txt, 

*  statisticsLastHour.txt,  statisticsPreviousFiveMinutes.txt,  and 

*  statisticsDateMM-DD-YYYY.txt. 
* 

*  @author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  (Aversion  1.0 
*/ 

public  class  FileCatalog{ 

Calendar  rightNow; 

String  prefix; 

String  dateRef; 

int  minuteRange,  hourRange; 

boolean  f lgFirstDataMin; 

File  min5,  min51ast, hour,  hourlast,  header; 

*  Constructor.  It  checks  if  there  are  previous  data  from  the  same  session 

*  and  transfers  these  data  to  the  correct  statisticsDateMM-DD_YYYY.txt  file. 

*  Then  it  clears  all  "five  minutes"  and  "hour"  data  files. 

*  <P> 

*  @param  pref  a  string  containing  the  directory  where  the  data  must  be  written 
V 

public  FileCatalog(  String  pref ) { 

prefix  =  pref; 

//  creates  File  objects 

min5  =  new  File (  prefix  +  "LastFiveMinutes.txt"); 

min51ast  =  new  File (  prefix  +  "PreviousFiveMinutes.txt"); 

hour  =  new  File (  prefix  +  "LastHour.txt"); 

hourlast  =  new  File (  prefix  +"PreviousHour . txt" ) ; 

header  =  new  File (  prefix  +  "Header.txt"); 

//  retrieves  the  date  of  last  record  for  this  session 
String  lastDateRef  =  retrieveDateRef ( ) ; 

//  copies  the  header  file  to  the  session  directory  if  it  does  not  exit 
if(  !  header . exists ( )  ){ 

concatenate (  prefix  +  "Header.txt"  ,  "Header.txt"  ); 
} 
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if(  min5 . exists ()) { 

//  if  there  is  a  last  five  minutes  file,  transfers  its  contents  to  the 
//  last  hour  file  and  deletes  the  last  five  minutes  file 
if(  lastDateRef  !=  null  ){ 

concatenate (prefix  +  "LastHour.txt"  ,  prefix  +  "LastFiveMinutes.txt"  ) ; 
} 
min5 . delete ( )  ; 

} 

//  deletes  the  previous  five  minutes  file  if  it  exists 
if (  min51ast . exists ()) { 

min51ast . delete ( )  ; 
} 

if (  hour .exists ())  { 

//  if  there  is  a  last  hour,  transfers  its  contents  to  the 
//  related  date  file  file  and  deletes  the  last  hour  file 
if(  lastDateRef  !=  null  ){ 

String  dateFileName  =  new  String (prefix  +"Date"  +  lastDateRef +". txt") ; 

concatenate (  dateFileName  ,  prefix  +  "LastHour.txt"  ) ; 
} 

hour . delete ( ) ; 
} 

//  deletes  the  previous  hour  file  if  it  exists 
if(  hourlast .exists ()) { 

hourlast . delete ( ) ; 
} 

flgFirstDataMin  =  true; 


} 


/■*■* 

*  Method  that  will  update  the  files,  transfering  data  from 

*  statisticsLastReport.txt  to  the  appropriate  files. 
•*■ 

*  @param  time  the  current  time  as  a  Calendar  object. 
*/ 

public  void  update (  Calendar  time) { 

rightNow  =  time; 

//  displays  the  current  time  on  the  console 
System. out .println (  rightNow. getTime ( )  . toString ( ) )  ; 
//  minuteRangeNow  represents  a  block  of  five  minutes 
int   minuteRangeNow  =  rightNow. get (Calendar .MINUTE)  /  5; 

int   hourRangeNow  =  rightNow. get (Calendar . H0UR_0F_DAY)  ; 

String  dateNow  =  new  String (  (rightNow. get (Calendar .MONTH)  +  1)  +  "-"  + 

rightNow. get (Calendar. DAY_0F_M0NTH)+  "-"  + 
rightNow. get (Calendar. YEAR)  ); 
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//  if  it  is  the  first  report  of  the  session 
if (flgFirstDataMin) { 

minuteRange  =  minuteRangeNow; 

hourRange  =  hourRangeNow; 

dateRef  =  dateNow; 

saveDateRef (dateRef)  ; 

flgFirstDataMin  =  false; 
} 

if(  minuteRangeNow  !=  minuteRange  ){ 

//  if  it  is  new  block  of  five  minutes 

//  appends  data  from  the  five  minutes  file  to  the  last  hour  file 
concatenate (  prefix  +  "LastHour.txt"  ,  prefix  +  "LastFiveMinutes.txt"); 
if(  min51ast . exists ()) { 

min51ast . delete ( ) ; 
} 

//  rename  last  five  minutes  file  to  previous  five  minutes  file 
min5 . renameTo (min51ast )  ; 
minuteRange  =  minuteRangeNow; 

if(  hourRangeNow  !=  hourRange  ){ 

//  if  it  is  a  new  hour 

//  appends  data  from  the  last  hour  to  the  related  date  file 
String  dateFileName  =  new  String (prefix  +  "Date"  +  dateRef  +  ".txt" 
concatenate (  dateFileName  ,  prefix  +  "LastHour.txt"  ); 
if(  hourlast . exists ( )  ){ 

hourlast . delete ( ) ; 
} 

//  renames  the  last  hour  file  as  the  previous  hour  file 
hour . renameTo (hourlast )  ; 
hourRange  =  hourRangeNow; 

//  if  it  is  a  new  date  save  the  actual  date  in  the 

//  statisticsLastDateRef  file 

if(  !  dateRef . equals (  dateNow  )  ){ 

dateRef  =  dateNow; 

saveDateRef (dateRef) ; 


} 


} 


//  if  there  is  not  a  new  five  minutes  block  just  append  the  last  report 

//  to  the  existing  last  five  minutes  file 

concatenate (  prefix  +  "LastFiveMinutes.txt",  prefix  +  "LastReport.txt"  ); 
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*  Utility  to  concatenate  two  files. 

*  @param  filel  the  first  file  (  filel  <-  filel  +  file2  ) .  If  filel  does  not 

*  exits  this  method  will  copy  file2  to  filel. 

*  <P> 

*  @param  file2  the  file  to  be  appended  to  filel. 
*/ 

public  static  void  concatenate  (  String  filel,  String  file2  ){ 

try{ 

FileOutputStream  output  =  new  FileOutput Stream (  filel,  true  ) ; 

FilelnputStream  input  =  new  FilelnputStream (  file2  ) ; 

int  mybyte; 

while (  (mybyte  =  input . read () )  !=  -1  ){ 

output .write (mybyte) ; 
} 

output . close ( )  ; 
input . close ( )  ; 

} 

catch (  FileNotFoundException  e){ 

System. out .println ( "File  not  found  "  +  e . getMessage ())  ; 

} 

catch (  IOException  e  ){ 

System. out .println ( "IOException  :  "  +  e . getMessage ())  ; 
} 


*  This  method  saves  in  a  file  a  date  in  a  string  format.  It  is 

*  used  for  save  the  date  of  the  last  report. 

*  The  file  name  is  statisticsLastDateRef.txt. 
* 

*  @param  dater  a  string  representing  a  date  as  DD-MM-YYYY 
*/ 

public  void  saveDateRef (  String  dater  ) { 
try{ 

DataOutputStream  output  =  new  DataOutputStream ( 

new  FileOutputStream (  prefix  +  "LastDateRef.txt") 

output .writeUTF(  dater  ) ; 
output . close ( ) ; 

} 

catch (  FileNotFoundException  e) { 

System. out .println ( "File  not  found  "  +  e . getMessage ())  ; 
} 

catch (  IOException  e  ){ 

System. out .println ( "IOException  :  "  +  e . getMessage ()) ; 
} 
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/*  * 

*  This  method  retrives  a  date  in  a  string  format  from  the  file 

*  statisticsLastDateRef.txt. 

* 

*  @return  string  representing  a  date  as  DD-MM-YYYY 
*/ 

public  String  retrieveDateRef ( ) { 

String  result  =  null; 

try{ 

DatalnputStream  input  =  new  DatalnputStream ( 

new  FileInputStream(  prefix  +  "LastDateRef.txt") 

result  =  input .readUTF( ) ; 
input . close ( ) ; 

} 

catch  (  FileNotFoundException  e){} 

catch (  IOException  e  ){ 

System. out . println ( "IOException  :  "  +  e . getMessage ( ) ) ; 
} 
return  result; 


}  //  end  of  class  FileCatalog 
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package  org. web3d. vrtp. rtp; 

import  java.awt.*; 
import  Java. awt . event . *; 

import  java.io.*; 

/** 

*  A  Dialog  to  display  and  modify  the  program  preferences. 

*  <P> 

+ 

*  @author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  @version  1 . 0 
*/ 

public  class  Modif yPreferences  extends  Dialog  { 

protected  Checkbox  recordBox,  partBox,  playBox; 

protected  Label  intervalLabel,  intervalPresLabel,  endLabel,  viewerLabel; 

protected  TextField  intervalText ,  intervalPresText ,  viewerText; 

protected  Choice  endChoice; 

private    String  []  strEndsIn  =  {  "1  hour",  "2  hours",  "4  hours", 

"8  hours",  "12  hours",  "24  hours",  "2  days",  "1  week"}; 

*  Constructor. 

*  <P> 

*  Sparam  parent  the  parent  frame 
*/ 

public  Modif yPreferences (Frame  parent) { 

super  (  parent,  "Preferences"  ,  true  ); 

setSize(  260  ,  280  ) ; 

setLayout (null) ; 

setBackground (Color . lightGray ) ; 

addWindowListener (  new  CloseWindow ( )  ) ; 

partBox  =  new  Checkbox ( "Send  RTCP  packets",  true); 
partBox. setBounds (10, 30, 140, 25) ; 
partBox . setBackground (Color . lightGray) ; 
add (partBox) ; 

playBox  =  new  Checkbox ( "Play  incoming  media",  true); 
playBox. setBounds (10, 60, 160, 25) ; 
add (playBox) ; 

recordBox  =  new  Checkbox ( "Record  statistics",  true) ; 
recordBox. setBounds (10, 90, 140,25) ; 
add (recordBox) ; 

intervalLabel  =  new  Label (  "Record  Interval (sec) ") ; 
intervalLabel. setBounds (  10,  120,  120,  25  ) ; 
add (intervalLabel) ; 

intervalText  =  new  TextField ( "30 . 0" ) ; 
intervalText. setBounds (130, 120, 40, 25) ; 
add (intervalText ) ; 

intervalPresLabel  =  new  Label (  "Presentation  Interval (sec) ") ; 
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intervalPresLabel. setBounds (  10,  150,  140,  25  )  ; 
add (intervalPresLabel) ; 

intervalPresText  =  new  TextField ( "5" ) ; 
intervalPresText . setBounds (160,  150,  40,25); 
add (intervalPresText )  ; 

endLabel  =  new  Label (  "Monitoring  Period"); 
endLabel. setBounds (  10,  180,  100,  25  ); 
add (endLabel)  ; 

endChoice  =  new  Choice ( ) ; 
endChoice. setBounds (120,  180,  80,  25); 
add (endChoice) ; 

for(int  ii=0;  ii  <  strEndsIn. length;  ++ii){ 
endChoice. add (strEndsIn [ii] ) ; 

} 

endChoice . select ( 0 ) ; 

viewerLabel  =  new  Label (  "External  viewer:"); 
viewerLabel. setBounds (  10,  210,  120,  25  ); 
add (viewerLabel)  ; 

viewerText  -  new  TextField ( "c: /Program  Files/accessories/wordpad. exe"  ] 

viewerText. setBounds (20,240,230,  20) ; 

viewerText .setFont (  new  Font (  null  ,  Font. PLAIN  ,  10  )  ); 

add (viewerText ) ; 

loadPreferences ( ) ; 


} 


/*.* 

*  Enables  the  GUI  input  elements 
*/ 

public  void  enablelnput ( ) { 

recordBox . setEnabled (true) ; 

partBox. setEnabled (true) ; 

playBox. setEnabled (true) ; 

intervalText . setEnabled (true) ; 

intervalPresText . setEnabled (true) ; 

endChoice. setEnabled (true) ; 

viewerText . setEnabled (true) ; 
} 

*  Disables  the  GUI  input  elements 
*/ 

public  void  disablelnput ( ) { 

recordBox . setEnabled ( false ) ; 
partBox . setEnabled ( false) ; 
playBox . setEnabled (false) ; 
intervalText . setEnabled ( false)  ; 
intervalPresText . setEnabled (false) 
endChoice. setEnabled (false) ; 
viewerText . setEnabled (false)  ; 
} 
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*  Saves  the  preferences  in  the  file  preferences.txt 
*/ 

public  void  savePreferences ( ) { 
try{ 

DataOutputStream  output  =  new  DataOutputStream ( 

new  FileOutputStream( "preferences .txt")  ); 

output . writeBoolean (  partBox. getState ( ) ) ; 
output . writeBoolean (  playBox. getState ( ) )  ; 
output . writeBoolean (  recordBox . getState ( ) )  ; 
output . writeUTF ( intervalText . getText ( )  )  ; 
output . writeUTF ( intervalPresText . getText ( ) )  ; 
output . writelnt (endChoice . getSelectedlndex ( ) )  ; 
output . writeUTF ( viewerText . getText ( )  )  ; 

output . close ( ) ; 

} 

catch (  FileNotFoundException  e)  { 

System. out . println ( "File  not  found  "  +  e . getMessage ())  ; 
} 

catch (  IOException  e  ){ 

System. out .println ( "IOException  :  "  +  e . getMessage ()) ; 
} 
} 

/■*•■*• 

*  Loads  the  preferences  from  the  file  preferences.txt 
*/ 

private  void  loadPreferences ( ) { 

try{ 

DatalnputStream  input  =  new  DatalnputStream ( 

new  FilelnputStream (  "preferences.txt")  ); 

partBox . setState  f input . readBoolean ( ) ) ; 
playBox . setState ( input . readBoolean ( ) ) ; 
recordBox. setState (input . readBoolean ( ) ) ; 
intervalText . setText ( input . readUTF ( ) )  ; 
intervalPresText . setText ( input . readUTF ( )  )  ; 
endChoice . select ( input . readlnt ( ) )  ; 
viewerText . setText ( input . readUTF ( ) ) ; 

input . close ( ) ; 

} 

catch (  FileNotFoundException  e) { } 

catch (  IOException  e  ){ 

System. out .println ( "IOException  :  "  +  e . getMessage ())  ; 
} 

} 
}  //  end  of  class  ModifyPreferences 
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package  org. web3d. vrtp. rtp; 

import  j avax. media . rtp. * ; 
import  javax .media . rtp. event . * ; 
import  j avax. media . rtp. rtcp. * ; 

import  java.io.*; 
import  java.sql.*; 
import  java.util.*; 

/*  * 

*  A  class  used  by  RtpMonitorManager  objects  to  write  the  statistics 

*  periodically  to  disk.  It  is  created  as  a  separate  thread  that  waits  for 

*  a  fixed  period  of  time  after  writing  data  to  disk. 

*  <P> 

*  This  class  writes  data  to  the  file  called  "statisticsLastReport.txt",  that 

*  contains  only  the  last  single  report.  The  FileCatalog  class  is  actually 

*  responsible  for  transferring  the  data  to  the  file 

*  "statisticsLastFiveMinutes.txt"  and  other  files. 
* 

*  @author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  (Aversion  1.0 
*/ 

public  class  RecordTask  implements  Runnable  { 

SessionManager  mgr; 
RtpMonitorManager  myMon; 
Thread  thread; 
boolean  flgRun; 
PrintStream  output; 
String  dir; 
String  prefix; 
String  filename; 
Calendar  timeNow; 
FileCatalog  cat; 
int  recordParam; 

*  Constructor.  It  creates  the  session  directory  where  the  stats  files  will  be 

*  written.  Also  it  creates  a  FileCatalog  object  that  will  organize  the  data  in 

*  several  files  (five  minutes,  hour  and  day). 
* 

*  @param  mon  the  RtpMonitorManager  that  manages  the  monitoring  session. 

*  <P> 

*  @param  reclnterval  the  interval  between  statistic  samples,  in  seconds. 
*/ 

public  RecordTask (RtpMonitorManager  mon,  double  reclnterval)  { 

//  saves  parameters  as  internal  variables 

myMon  =  mon; 

recordParam  =  (int)  (reclnterval  *  1000); 

//  gets  the  session  manager  associated  with  the  monitoring  session 
mgr  =  myMon. getSessionManager () ; 


155 


//  gets  session  address  and  port 

String  session  =  myMon. getMediaLocator (). getSessionAddress () ; 

String  port  = 

(new  Integer (myMon. getMediaLocator ( ) . getSessionPort ( ) ) ) . toString ( ) ; 

//  creates  a  new  subdirectory  for  saving  session  statistics 

dir  =  new  String (  "./session"  +  session. replace ('.','-' )  +  "port"  +port 

File  newdir  =  new  File (dir); 

newdir .mkdir ( ) ; 

//  creates  file  statisticsLastReport.txt 
prefix  =  new  String (  dir  +  "/statistics"  ); 
filename  =  new  String  (  prefix  +  "LastReport.txt"  ); 

//  creates  a  FileCatalog  object 
cat  =  new  FileCatalog (  prefix  ) ; 

//  executes  as  a  thread 

thread  =  new  Thread (this, "Record  thread"); 

thread. setDaemon (true) ; 

thread. start ( ) ; 


/ 


*  * 


*  Resets  a  flag  that  is  checked  each  time  the  thread  associated  with  this 

*  object  is  awaken  after  the  wait  command,  causing  the  thread  to  end. 
* 

*/ 

public  void  exit ( ) { 

flgRun  =  false; 
}■ 

/  *  * 

*  Starts  executing  the  recording  and  waiting  until  the  recording  interval 

*  is  over,  in  a  loop,  until  the  "exit"  method  is  called. 

* 

V 

public  void  run ( ) { 

flgRun  =  true; 

//  runs  continuously  until  stopped 
while (flgRun) { 

try  { 

//  opens  the  last  report  file 

output  =  new  PrintStream(  new  FileOutputStream (  filename,  false)  ); 

//  gets  actual  time 

timeNow  =  Calendar . getlnstance () ; 

//  records  statistics  on  file 
recordGlobalStats ( ) ; 
recordStreamStats ( ) ; 
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recordFeedbacks ( ) ; 

//  calls  the  FileCatalog  object  to  manage  the  data  between  the 
//  several  files 
cat . update ( timeNow) ; 


} 

catch  (FileNotFoundException  e) { 

System. out .println (  "In  RecordTask 
} 
finally  { 

output . close ( ) ; 
} 
try{ 

Thread. sleep (recordParam) ; 
} 
catch  ( InterruptedException  e) { } 


"  +  e . getMessage ( ) 


Records  global  statistics  (  lines  starting  with  Dl  ) 


*/ 

private  void  recordGlobalStats ( ) { 

GlobalReceptionStats  stats  =  mgr . getGlobalReceptionStats ( ) ; 


output .print 
output . print 

output .print 
output .print 
output .print 
output .print 
output .print 
output. print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 


"Dl  "); 

(new  Time (timeNow. getTime ( ) . getTime ( ) ) . toString ( 

'  '); 

mgr.  getAHParticipants  ( )  .  size  ( )  )  ; 

'  '); 

mgr . getRemoteParticipants ( )  . size  ( )  ) ; 

'  '); 

mgr . getActiveParticipants  ( )  . size  ( )  ) ; 

'  '); 

stats . getBytesRecd ( )  ) ; 

'  '); 

stats . getPacketsRecd ( )  ); 

'  '); 

stats. getRTCPRecd ( )  ); 

'  '); 

stats . getSRRecd ( )  )  ; 

'  '); 

stats. getBadRTPkts ( )  ); 

'  '); 

stats. getBadRTCPPkts ()  ) ; 

'  '); 

stats . getMalf ormedSR ( )  )  ; 

'  '); 

stats . getMalf ormedRR ( )  ); 

'  '); 

stats. getMalf ormedSDES ( )  ); 


)  ; 
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output .print ( '  '); 

output .print (stats . getMalformedBye ( )  ) ; 

output .print  ( '  '); 

output .print (stats . getLocalColls ( )  ) ; 

output .print  (  '  '); 

output .print (stats . getRemoteColls ( )  ) ; 

output .print ( '  '); 

output .print (stats . getPacketsLooped ( )  ) 

output .print ( '  '); 

output .print (stats . getTransmitFailed ( ) 

output .print ( '  '); 

output .println (stats . getUnknownTypes ( ) 


} 


/■*■  * 

*  Records  stream  statistics  (  lines  starting  with  D2  ) 
* 

*/ 

private  void  recordStreamStats ( ) { 

ReceiveStream  stream; 
ReceptionStats  stats; 
Participant  part; 
long  SSRC; 
String  CNAME; 

Vector  aux  =  mgr . getReceiveStreams ( )  ; 
for(int  ii  =  0;  ii<  aux.size();  ++ii){ 

stream  =  (ReceiveStream)  aux. elementAt (ii ) ; 
part  =  stream. getParticipant () ; 
SSRC  =  RtpUtil.correctSSRC (stream. getSSRC ()) ; 
if (part  !=  null) { 

CNAME  =  stream. getParticipant () .getCNAME () ; 
} 
else  { 

CNAME  =  new  String ( "Unknown  Participant"); 
} 
stats  =  stream. getSourceReceptionStats () ; 

output. pr int  (  "D2  "); 
output .print (  CNAME  ); 
output .print ( '  '); 
output .print (SSRC) ; 
output .print ( '  '); 

output .print (stats . getPDUlost ( )  ) ; 
output .print ( '  '); 

output .print (stats . getPDUProcessed ( )  ) ; 
output .print ( '  '); 

output . print (stats . getPDUMisOrd ( )  ) ; 
output .print ( '  '); 

output .print (stats . getPDUInvalid ( )  ) ; 
output . print ( '  ' ) ; 

output .println (stats . getPDUDuplicate ( )  ) ; 
} 
} 
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*  Records  feedback  statistics  (  lines  starting  with  D3  ) 
• 

*/ 

private  void  recordFeedbacks ( ) { 

Participant  part; 

Vector  reports,  feedbacks; 

Report  rep; 

Feedback  feedbk; 

String  CNAME; 

long  fromSSRC,  aboutSSRC; 

double  fraction; 

long  packetsLost,  jitter; 

Vector  aux  =  mgr .  getAHParticipants  ( )  ; 

for(int  ii  =  0;  ii<  aux.size();  ++ii){ 

part  =  (Participant ) aux. elementAt (ii) ; 
CNAME  =  part.getCNAMEO  ; 
reports  =  part . getReports ( ) ; 
f  or  (  int  jj=0;  jj<  reports . size () ;  ++jj){ 
rep  =  (Report)  reports . elementAt (j j ) ; 
fromSSRC  =  RtpUtil . correctSSRC (  rep. getSSRC ( )  ); 
feedbacks  =  rep. getFeedbackReports ( ) ; 
f or (  int  kk=0;  kk  <  feedbacks . size  () ;  +  +  kk)  { 
feedbk  =  (Feedback)  feedbacks . elementAt (kk) ; 
aboutSSRC  =  RtpUtil . correctSSRC (  feedbk. getSSRC ( )  ); 
fraction  =  (feedbk. getFractionLost ()) /256 . 0; 
packetsLost  =  feedbk. getNumLost () ; 
jitter  =  feedbk. getJitter () ; 


output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .print 
output .println (  jitter  ); 


"D3  "); 
CNAME  ) ; 

')  ; 
fromSSRC  ) ; 

*)  ; 
aboutSSRC  ) ; 

')  ; 
fraction  ) ; 

'); 
packetsLost  ) ; 

'); 


return; 


}  //  end  of  class  RecordTask 
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package  org. web3d. vrtp. rtp; 

import  j avax. media . * ; 
import  j avax. media . rtp. * ; 
import  Java. lang. * ; 
import  java.net.*; 

/*  * 

*  A  class  that  represents  necessary  information  to  define 

*  an  RTP  session,  as  address,  port  and  TTL. 
* 

*  <P> 

*  @author      Francisco  Afonso    (afonso@cs.nps.navy.mil) 

*  (Aversion   1.0 
*/ 

public  class  RtpMediaLocator  extends  MediaLocator{ 

/■*■* 

*  Defines  the  value  of  TTL  if  not  provided. 

*/ 

public  static  final  int  TTL_UNDEFINED  =  1; 

private  String  address  =  ""; 

private  int  port; 

private  int  ttl  =  TTL_UNDEFINED; 

*  Constructor. 

*  @param  locatorString  Describes  the  session.  It  should  have  the 

*  following  format: 

rtp: //address :port [/ttl]  ,  where: 

*  <P> 

*  address  ->  multicast  address  of  the  rtp  session 

*  <P> 

*  port     ->  port  number 

*  <P> 

*  ttl  (optional)  ->  time-to-live 
'*/ 

public  RtpMediaLocator (String  locatorString)  throws  Malf ormedURLException 

{ 

super (  locatorString) ; 

parseLocator (  locatorString); 
} 

//  this  method  parses  the  locator  string  to  get  the  various  session  data 

//  as  address,  port  and  ttl 

private   void  parseLocator (String  locatorString) 

throws  MalformedURLException{ 

String  remainder  =  getRemainder ( ) ; 

int  colonlndex  =  remainder . indexOf (":") ; 
int  slashlndex  =  remainder . indexOf ("/",  2  )  ; 
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//  gets  the  address 
if  (colonlndex  !=  -1) 

address  =  remainder . substring (2,  colonlndex); 
else  { 

throw  new  Malf ormedURLException ( 

"RTP  MediaLocator  is  Invalid.  Must  be  of  form  rtp: //addr :port/ttl" ) 
} 

//  tests  if  the  address  is  valid 
try{ 

InetAddress  Iaddr  =  InetAddress  .  getByNarne  (address)  ; 

} 

catch  (UnknownHostException  e) {throw  new  Malf ormedURLException ( 

"Valid  RTP  Session  Address  must  be  given"); 
} 

//  gets  the  port 
String  portstr  =  ""; 
if  (slashlndex  ==  -1) 

portstr  =  remainder . substring (colonlndex  +1, 

remainder . length ( ) ) ; 
else 

portstr  =  remainder . substring (colonlndex  +1, 

slashlndex) ; 

//  tests  if  the  port  is  an  integer 
try{ 

Integer  Iport  =  Integer . valueOf (portstr ) ; 

port  =  Iport . intValue () ; 
}catch  (NumberFormatException  e) { 

throw  new  Malf ormedURLException ( 

"RTP  MediaLocator  Port  must  be  a  valid  integer"); 
} 

//  gets  the  ttl 

if  (slashlndex  !=  -1)  { 

String  ttlstr  =  remainder . substring (slashlndex+l, 

remainder . length ( ) ) ; 
try{ 

Integer  Ittl  =  Integer . valueOf (ttlstr) ; 

ttl  =  Ittl. intValue () ; 
}catch  (NumberFormatException  e) { } 


/**  Returns  the  RTP  Session  address 

*@return  String  form  of  the  RTPSession  address 

*/ 
public  String  getSessionAddress ( ) { 

return  address; 
} 
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I  -k-k 

*  Returns  the  RTP  session  port. 

*  ©return  RTP  session  port 
*/ 

public  int  getSessionPort ( ) { 

return  port; 
} 

/** 

*  Returns  the  session  Time-to-live. 

*  @return  time-to-live (TTL) 
*/ 

public  int  getTTL(){ 

return  ttl; 
} 

}  //  end  of  class  RtpMediaLocator 
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package  org. web3d. vrtp. rtp; 

import  javax .media . rtp. * ; 
import  javax .media . rtp. event . *; 
import  javax. media . rtp. rtcp. * ; 

import  j ava . awt . * ; 
import  Java . awt . event . *; 
import  java.net.*; 
import  java.io.*; 
import  java . util . * ; 

/*■* 

*  The  RtpMonitor  Application. 

*  <P> 

*  This  class  is  a  frame  that  implements  the  RtpMonitor  GUI.  <P> 

*  If  any  command  line  argument  is  passed  the  RtpMonitorCommandLine  class 

*  is  called  instead. 
■*■ 

*  ©author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  (Aversion  1.0 
*/ 

public  class  RtpMonitor  extends  Frame 

implements  ActionListener,  ItemListener  { 

TextField  sessionText,  sessionNameText; 

TextArea  activeArea, passiveArea, feedbkArea; 

Choice  streamChoice; 

Button  start, stop, changeStream; 

Label  sessionLabel,  sessionNameLabel,  streamLabel,  feedbkLabel; 

Label  endLabel; 

Label  globalStatLabel,  activeLabel,  passiveLabel,  f eedbkFieldsLabel; 

Label  []  gLab; 

TextField  []  gText; 

String  []  gField  =  {"Total  Bytes",  "Total  Packets",  "RTCP  Packets", 

"SR  Packets",  "Bad  RTP  Packets",  "Bad  RTCP  Packets", 
"Bad  SR  Packets", "Bad  RR  Packets",  "Bad  SDES  Packets' 
"Bad  BYE  Packets",  "Local  Collisions", 
"Remote  Collisions",  "Looped  Packets", 
"Failed  Transmission",  "Unknown  Type"  } ; 

Label  []  rLab; 

TextField  []  rText; 

String  []  rField  =  {"Lost  PDUs",  "Processed  PDUs",  "MisOrdered  PDUs", 

"Invalid  PDUs",  "Duplicate  PDUs"  } ; 

int  []  endsInHours  =  {  1,  2,  4,  8,  12,  24,  48,  168  }  ; 

String  locator; 

boolean  flgPart,  flgPlay,  flgRecord; 

boolean  flgActive  =  false; 

int  preslnterval; 

double  reclnterval; 

RtpMonitorManager  monMgr; 

SessionManager  mymgr; 

DisplayTask  dispTask; 

long  SSRCtoShow; 

Hashtable  streamTable; 

boolean  flgUpdateSt reams; 
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Date  endDate; 

MenuBar  bar; 

Menu  preferences,  bookmarkMenu,  filesMenu,  helpMenu; 

Menultem  viewPref,  modif yPref ,  selectBm,  addBm,  deleteBm,  aboutltem; 

Menultem  last5Item,  previous5Item,  lastHourltem,  previousHourltem,  headerltem; 

Menultem  exitltem; 

Modif yPref erences  modPref Dialog; 

SelectBookmark    selBmDialog; 

DeleteBookmark    delBmDialog; 

AddBookmark       addBmDialog; 

About  aboutDialog; 

/** 

*  Constructor.  It  is  called  by  main ( )  if  no  command  line  argument  is  passed. 

*  <P> 

*  The  constructor  initializes  the  GUI  components. 
*/ 

public  RtpMonitorO 
{ 

super  (  "RtpMonitor") ; 

setSize (780, 530) ; 

setLayout (  null  ) ; 

preferences  =  new  Menu ( "Preferences" ) ; 

viewPref  =  new  Menultem ( "View") ; 
viewPref . addActionListener ( this ) ; 
modif yPref  =  new  Menultem ( "Modify" ) ; 
modif yPref . addActionListener (this) ; 

preferences . add (  viewPref  ); 
preferences . addSeparator ( ) ; 
preferences . add (  modif yPref  ); 

bookmarkMenu  =  new  Menu ( "Bookmarks" ) ; 

addBm  =  new  Menultem ( "Add" ) ; 
addBm. setEnabled (false) ; 
deleteBm  =  new  Menultem ( "Delete" ) ; 
selectBm  =  new  Menultem ( "Select" ) ; 
selectBm. addActionListener (this) ; 
deleteBm. addActionListener ( this ) ; 
addBm. addActionListener (this) ; 

bookmarkMenu. add (  selectBm  ); 
bookmarkMenu . addSeparator ( ) ; 
bookmarkMenu. add (  addBm  ); 
bookmarkMenu . addSeparator ( )  ; 
bookmarkMenu. add (  deleteBm  ); 

filesMenu  =  new  Menu ( "File" ) ; 

last5Item  =  new  Menultem ( "Last  five  minutes"); 
last5Item. addActionListener (this) ; 

previous5Item  =  new  Menultem ( "Previous  five  minutes"); 
previous5Item. addActionListener (this) ; 
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lastHourltem  =  new  Menultem ( "Last  hour"); 
last Hour It em. addActionListener (this)  ; 
previousHourltem  =  new  Menultem ( "Previous  hour"); 
previous Hour I tern. addActionListener (this) ; 
headerltem  =  new  Menultem ( "Header" ) ; 
headerltem. addActionListener (this) ; 
exitltem  =  new  Menultem ( "Exit" ) ; 
exit I tern. addActionListener (this) ; 


f ilesMenu. add (  last5Item  ); 

f ilesMenu. add (  previous5Item  ); 

f ilesMenu. add (  lastHourltem  ); 

f ilesMenu. add (  previousHourltem  ); 

f ilesMenu . addSeparator ( ) ; 

f ilesMenu. add (  headerltem  ); 

f ilesMenu . addSeparator ( ) ; 

f ilesMenu. add (  exitltem  ); 

helpMenu  =  new  Menu ( "Help" ) ; 

aboutltem  =  new  Menultem ( "About ") ; 
aboutltem. addActionListener (this) ; 
helpMenu. add (  aboutltem); 

bar  =  new  MenuBar ( ) ; 
bar . add (f ilesMenu) ; 
bar . add (bookmarkMenu) ; 
bar . add (preferences) ; 
bar . add (helpMenu) ; 

setMenuBar (  bar  ) ; 

modPref Dialog  =  new  Modif yPref erences (this ) ; 

sessionLabel  =  new  Label (  "Session  Address"); 
sessionLabel . setBounds (  10,  60,  100,  25  ); 
add(sessionLabel) ; 

sessionText  =  new  TextField  (  "rtp: // . . . : / "); 

sessionText . setBounds ( 110, 60,  230,  25  ); 
add (sessionText) ; 

sessionNameLabel  =  new  Label (  "Session  Name"); 
sessionNameLabel . setBounds (  360,  60,  90,  25  ); 
add (sessionNameLabel)  ; 

sessionNameText  =  new  TextField ("") ; 
sessionNameText .setBounds (450,  60,  180,  25  ); 
add (sessionNameText )  ; 

start  =  new  Button ( "Start ")  ; 
start .setBounds (  660,  60,  40,  25  ); 
start . addActionListener (  this  ); 
start . setEnabled (true)  ; 
add (start ) ; 
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stop  =  new  Button ("Stop") ; 
stop.setBounds (  720,  60,  40,  25  )  ; 
stop. addActionListener (  this  ); 
stop. setEnabled (false)  ; 
add (stop) ; 

globalStatLabel  =  new  Label (  "Global  Statistics"); 
globalStatLabel.setBounds (  160,  100,  100,  20  )  ; 
add (globalStatLabel)  ; 

gLab  =  new  Label [15]; 

gText  =  new  TextField[15] ; 

int  offsetx  =  0; 

int  offsety  =  0; 

for(  int  ii=0;  ii<  15;  ii++){ 

if (ii==8)  { 

offsetx=  220; 
offsety=-(ii*25) ; 

} 

gLab[ii]  =  new  Label (  gField[ii]  ); 

gLab[ii] .setBounds (  10+offsetx,  130+ (ii*25) +of f sety,  115,  20  ); 

add (  gLab [ii] ) ; 

gText [ii]  =  new  TextField(  ""  ); 

gText [ii] .setBounds (  125+offsetx,  130+ (ii*25) +off sety,  90,  20  ); 

gText [ii] .setEditable (false) ; 

add(  gText [ii] ) ; 

} 

activeLabel  =  new  Label (  "Active  Participants"); 
activeLabel. setBounds (  50,  340,  140,  20  ); 
add (activeLabel) ; 

activeArea  =  new  TextArea (  "",  0,  0,  TextArea. SCROLLBARS_BOTH  ); 

activeArea. setBounds (10, 360,  175,  180); 

activeArea. setFont (  new  Font (  "Courier"  ,  Font. PLAIN  ,  12  )  ); 

activeArea. setEditable (false) ; 

add (activeArea) ; 

passiveLabel  =  new  Label (  "Passive  Participants"); 
passiveLabel. setBounds (  230,  340,  140,  20  ); 
add (passiveLabel) ; 

passiveArea  =  new  TextArea (  "",  0,  0,  TextArea . SCROLLBARS_BOTH  ); 

passiveArea. setBounds (195,  360,  175,  180); 

passiveArea. setFont (  new  Font (  "Courier"  ,  Font . PLAIN  ,  12  )  ); 

passiveArea. setEditable (false) ; 

add (passiveArea) ; 

streamLabel  =  new  Label (  "Stream"); 
streamLabel. setBounds (  470,  120,  50,  25  ); 
add (streamLabel ) ; 

streamChoice  =  new  Choice ( ) ; 
streamChoice . setBounds (520,  120,  250,  25); 
streamChoice . setEnabled ( false )  ; 
streamChoice . addltemListener ( this ) ; 
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add (streamChoice) ; 

changeStream  =  new  Button  (  "Change" ) ; 
changeStream. setBounds (  720,  150,  50,  25  ) ; 
changeStream. addActionListener (  this  ) ; 
changeStream. setEnabled ( false) ; 
add (changeStream) ; 

rLab  =  new  Label [5] ; 
rText  =  new  TextField [5] ; 
f or (  int  ii=0;  ii<  5;  ii++) { 

rLab[ii]  =  new  Label (  rField[ii]  ) ; 

rLab [ii]  .setBounds (  500,  170+ (ii*25)  ,  100,  20  ) ; 

add (  rLab [ii] ) ; 

rText [ii]  =  new  TextField (  ""  ) ; 

rText [ii] .setBounds (  605,  170+(ii*25),  90,  20  ) ; 

rText  [ii]  .setEditable (false) ; 

add(  rText  [ii] ) ; 

} 

feedbkLabel  =  new  Label  (  "Feedback  Reports"); 
f eedbkLabel. setBounds (  510,  315,  100,  20  ); 
add (feedbkLabel)  ; 

f eedbkFieldsLabel  =  new  Label ( 

"Username  Fraction  Lost        Jitter         Packets  Lost"; 

f eedbkFieldsLabel. setBounds (  420,  340,  350,  20  )  ; 
add (f eedbkFieldsLabel) ; 


feedbkArea  =  new  TextArea (  "",  0,  0,  TextArea . SCROLLBARS_VERTICAL_ONLY  ) ; 

feedbkArea. setBounds (410,  360,  360,  180); 

feedbkArea. setFont (  new  Font (  "Courier"  ,  Font. PLAIN  ,  12  )  ); 

feedbkArea . setEditable ( false) ; 

add ( feedbkArea )  ; 

setVisible (true)  ; 

streamTable  =  new  Hashtable ( ) ; 

this . addWindowListener (new  WindowAdapter ( ) { 
public  void  windowClosing (WindowEvent  e) { 

System. exit (0 ) ; 
} 
}); 
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/  *  * 

*  Takes  action  when  buttons  are  selected. 
■*• 

*/ 

public  void  actionPerformed (  ActionEvent  e  ) 
{ 

if(  e. getSource ( )  ==  start) { 
start . setEnabled( false) ; 
disablelnputs ( ) ; 

locator  =  sessionText . getText () ; 
reclnterval  =  Double .parseDouble ( 

modPref Dialog . intervalText . getText ( )  )  ; 
preslnterval  =  Integer .parselnt ( 

modPref Dialog. intervalPresText . getText ( ) ) ; 
flgPart  =  modPref Dialog. partBox. getState () ; 
flgPlay  =  modPref Dialog. playBox. getState () ; 
flgRecord  =  modPref Dialog. recordBox. getState () ; 
SSRCtoShow  =  0; 
endDate  =  new  Date (  (new  Date ( ) ) . getTime ( ) 

+  endsInHours [modPref Dialog. endChoice . getSelectedlndex ( ) ] *3600000L) ; 

if(  startSession ( )  ){ 

stop. setEnabled (true) ; 

addBm. setEnabled (true) ; 

changeStream. setEnabled (true) ; 

flgUpdateStreams  =  true; 
} 
else{ 

start . setEnabled (true) ; 

enablelnputs ( ) ; 
} 
} 

if(  e . getSource ( )  ==  stop) { 

flgActive  =  false; 

stop. setEnabled (false) ; 

addBm. setEnabled (false) ; 

monMgr . close ( )  ; 

monMgr  =  null; 

mymgr  =  null; 

clearAHData  ()  ; 

changeStream. setEnabled (false) ; 

start . setEnabled (true) ; 

enablelnputs  ( ) ; 
} 

if(  e . getSource ( )  ==  changeStream) { 
changeStream. setEnabled (false) ; 
flgUpdateStreams  =  false; 
clearStreamData ( ) ; 
streamChoice . setEnabled (true)  ; 
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if(  e . getSource ( )  ==  modifyPref ) { 

modPref Dialog . setTitle ( "Modify  Preferences" ) ; 
modPref Dialog . enablelnput ( ) ; 
modPref Dialog . setVisible (true) ; 
modPref Dialog . savePref erences ( ) ; 


if 


} 


} 


if 


} 


e . getSource ( )  ==  viewPref ) { 

modPref Dialog. setTitle ("View  Preferences"! 

modPref Dialog. disablelnput ( ) ; 

modPref Dialog. setVisible (true) ; 


if(  e . getSource () ==  selectBm) { 

selBmDialog    =  new  SelectBookmark (this) ; 

selBmDialog. setVisible (true) ; 

selBmDialog  =  null; 
} 

if (  e . getSource () ==  deleteBm) { 

delBmDialog   =  new  DeleteBookmark ( this) ; 
delBmDialog. setVisible (true) ; 
delBmDialog  =  null; 


e . getSource () ==  addBm) { 
addBmDialog    =  new  AddBookmark (this) ; 
addBmDialog. setVisible (true) ; 
addBmDialog  =  null; 


if(  e . getSource () ==  last5Item) { 

runViewer(  sessionText . getText ( )  ,  "LastFiveMinutes.txt"); 
} 
if(  e . getSource () ==  previous5Item) { 

runViewer (  sessionText . getText ( )  , 
} 
if(  e . getSource () ==  lastHourltem) { 

runViewer (  sessionText . getText  ( )  , 
} 
if (  e . getSource () ==  previousHourltem) { 

runViewer (  sessionText . getText ( )  , 
} 
if(  e . getSource () ==  headerltem) { 

runViewer (  sessionText . getText ( )  , 
} 
if(  e . getSource () ==  aboutltem) { 

aboutDialog    =  new  About (this); 

aboutDialog. setVisible (true) ; 

aboutDialog  =  null; 
} 

if (  e . getSource () ==  exitltem) { 
System. exit ( 0 ) ; 
} 


"PreviousFiveMinutes . txt ' 
"LastHour.txt") ; 
" PreviousHour . txt " )  ; 
"Header.txt") ; 
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*  starts  the  monitoring  session  by  creating  a  RtpMonitorManager  object. 
*/ 

private  boolean  startSession ( ) { 

//  tries  to  create  the  RtpMonitorManager  object 
try{ 

monMgr  =  new  RtpMonitorManager (locator,  flgPart,  flgPlay, 

flgRecord,  reclnterval) ; 

mymgr  =  monMgr . getSessionManager () ; 

} 

catch (  Malf ormedURLException  e  ){ 

f eedbkArea . setText ( 

"Malf ormedURLException  creating  RtpMonitorManager:"  +  ' \n'); 

f eedbkArea . append (  e . getMessage ( )  ); 

return  false; 
} 
catch (UnknownHostException  e  ){ 

f eedbkArea . setText ( 

"UnknownHostException  creating  RtpMonitorManager:"  +  '\n'); 

f eedbkArea . append (  e . getMessage ( )  ); 

return  false; 
} 
catch (  SessionManagerException  e  ){ 

f eedbkArea . setText ( 

"SessionManagerException  creating  RtpMonitorManager:"  +  ' \n'); 

f eedbkArea . append (  e . getMessage ( )  ); 

return  false; 
} 
catch (  IOException   e  ){ 

f eedbkArea. setText (  "IOException  creating  RtpMonitorManager:"  +  ' \n'); 

f eedbkArea . append (  e . getMessage ( )  ); 

return  false; 
} 

flgActive  =  true; 

//  creates  a  DisplayTask  object  to  update  the  statistics  on  screen 
dispTask  =  new  DisplayTask (  this,  preslnterval  ); 

return  true; 
} 

/** 

*  Updates  the  global  statistics. 
*/ 

public  void  showGlobalStats ( ) { 

GlobalReceptionStats  stats  =  mymgr . getGlobalReceptionStats () ; 

gText [0] .setText  (  new  Integer (stats . getBytesRecd ()). toString ( )  ); 

gText [1] . setText (  new  Integer (stats . getPacketsRecd ()). toString ( )  ); 

gText [2] .setText (  new  Integer (stats .getRTCPRecd ()). toString ( )  ); 

gText [3]  . setText (  new  Integer (stats . getSRRecd ()). toString ( )  ); 
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gText [4] .setText (  new  Integer (stats . getBadRTPkts ()). toString ( )  ) ; 
gText  [5]  .setText (  new  Integer (stats . getBadRTCPPkts ()). toString ( )  ); 
gText  [6]  .setText (  new  Integer (stats . getMalf ormedSR ()). toString ( )  ); 
gText [7]  .setText  (  new  Integer (stats . getMalf ormedRR ()). toString ( )  ) ; 
gText [8] .setText (  new  Integer (stats . getMalf ormedSDES ()). toString ( )  ); 
gText [ 9] . setText (  new  Integer (stats . getMalf ormedBye ()). toString ( )  ); 
gText [10] .setText (  new  Integer (stats . getLocalColls ()). toString ( )  ) ; 
gText  [11]  . setText (  new  Integer (stats . getRemoteColls ()). toString ( )  ); 
gText  [12]  .setText  (  new  Integer (stats . getPacketsLooped ()). toString  ( )  ) ; 
gText [13] .setText (  new  Integer (stats . getTransmitFailed ()). toString ( )  ) 
gText [ 14 ] . setText (  new  Integer (stats . getUnknownTypes ( ) ) . toString ( ) ) ; 

} 

*  Updates  the  lists  of  active  and  passive  participants. 

*/ 

public  void  showParticipants ( ) { 

act iveArea. setText ("")  ; 

Vector  aux  =  mymgr . getActiveParticipants () ; 

Participant  part; 

for(int  ii  =  0;  ii<  aux. size ();  ++ii){ 

part  =  (Participant ) aux. elementAt (ii) ; 

activeArea. append (  RtpUtil . getUsernameOrCNAME (part )  +  *\n'); 
} 

passiveArea. setText ( "")  ; 
aux  =  mymgr . getPassiveParticipants ()  ; 

for(int  ii  =  0;  ii<  aux. size ();  ++ii){ 

part  =  (Participant ) aux. elementAt (ii) ; 

passiveArea. append (  RtpUtil . getUsernameOrCNAME (part )  +  ' \n')# 
} 
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'  Updates  the  stream  statistics. 

public  void  showStreamStats ( ) { 

if(  ! flgUpdateStreams) { 

return; 
} 

ReceiveStream  dispStream  =  null; 
ReceiveStream  stream; 
ReceptionStats  stars; 
Participant  part; 
String  display; 
streamChoice . removeAll ( ) ; 
streamTable . clear ( )  ; 

Vector  aux  =  mymgr . getReceiveStreams () ; 
for(int  ii  =  0;  ii<  aux.sizeO;  ++ii)  { 
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stream  =  (ReceiveStream)  aux. elementAt (ii) ; 
part  =  stream. getParticipant () ; 
if  (part  !=  null)  { 

display  =  new  String (  RtpUtil . getUsernameOrCNAME (part )  +  "  /  "  + 

RtpUtil.correctSSRC  (stream.  getSSRCO  }  )  ; 
} 
else{ 

display  =  new  String (  "unknown_participant  /  "  + 

RtpUtil.correctSSRC  (stream.  getSSRCO  )  )  ; 
} 

streamChoice . add (display) ; 

streamTable .put (  display,  new  Long (  stream. getSSRC ( )  )  ); 

if(  stream. getSSRCO  ==  SSRCtoShow  ){ 
dispStream  =  stream; 
streamChoice . select ( ii ) ; 

} 


if (  SSRCtoShow  ==  0) { 
if (  aux. size  ()  >  0) { 

dispStream  =  (ReceiveStream)  aux . elementAt (0) ; 
SSRCtoShow  =  dispStream. getSSRCO ; 
} 
} 

if (  dispStream  ==  null) { 

for(int  jj-0;  jj<5;  ++jj){ 

rText [jj] .set Text (""J ; 
} 

SSRCtoShow  =  0; 
return; 
} 

stats  =  dispStream. getSourceReceptionStats () ; 

rText [0] .setText (  new  Integer (stats . getPDUlost ()). toString ()  ); 

rText [1] .setText  (  new  Integer (stats . getPDUProcessed ()). toString ()  ); 

rText [2] .setText (  new  Integer (stats . getPDUMisOrd ()). toString ()  ); 

rText [3] . setText (  new  Integer (stats . getPDUInvalid ()). toString ( )  ); 

rText [4]  .setText  (  new  Integer (stats . getPDUDuplicate ()). toString ( )  ); 
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*   Updates  the  stream  feedbacks. 
*/ 
public  void  showFeedbacks ( ) { 

if(  ! flgUpdateStreams) { 

return; 
} 

Participant  part; 

Vector  reports,  feedbacks; 

Report  rep; 

Feedback  feedbk; 

f eedbkArea . setText ( "" ) ; 

Vector  aux  =  mymgr  .  getAHParticipants  ( )  ; 

for(int  ii  =  0;  ii<  aux.size();  ++ii) { 

part  =  (Participant ) aux. elementAt (ii) ; 

reports  =  part . getReports ( ) ; 

f or  (  int  jj=0;  jj<  reports . size () ;  ++jj){ 
rep  =  (Report)  reports . elementAt (jj ) 
feedbacks  =  rep. getFeedbackReports ( ) 
f or (  int  kk=0;  kk  <  feedbacks . size () ;  ++kk) { 
feedbk  =  (Feedback)  feedbacks . elementAt (kk) ; 
if(  feedbk. getSSRC ( )  ==  SSRCtoShow  ){ 
f eedbkArea . append (  f illBlanks ( 

RtpUtil.getUsernameOrCNAME(part)  ,  19  )  +  "   "  ) ; 
double  fraction  =  (feedbk. getFractionLost ()) /256 . 0; 
f eedbkArea . append ( 

f illBlanks (  String. valueOf ( fraction) ,  6)  +  "     "  ); 
f eedbkArea . append ( 

fillBlanks (String. valueOf (feedbk. getJitter () ), 8)  +  " 
f eedbkArea . append ( 

fillBlanks (  String. valueOf (feedbk. getNumLost ( ) ) , 10) 
+  '  \n'  ); 

} 
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/*  * 

*  Take  action  when  selection  boxes  are  used. 

* 

*/ 

public  void  itemStateChanged (  ItemEvent  ie  ) 
{ 

if(  ie . getSource ( )  ==  streamChoice) { 

SSRCtoShow  =  ((Long)  streamTable . get (  ie.getltemO  )  ) . longValue ( ) ; 

f IgUpdateStreams  =  true; 
changeStream. setEnabled (true)  ; 
streamChoice . setEnabled ( false) ; 
} 


/ 


■*•  ■*• 


*  Clears  all  stats  info  on  screen. 

*/ 

private  void  clearAHData  ( )  { 

for(int  jj=0;  j j < 1 5 ;  ++jj){ 
gText [jj] .set Text ("") ; 

} 

for(int  jj=0;  jj<5;  ++jj){ 
rText  [jj]  .set Text ("") ; 

} 

activeArea . setText ( " " ) ; 
passiveArea. setText ( "" ) ; 
f eedbkArea . setText ( " " ) ; 

streamChoice . removeAll ( ) ; 
streamTable . clear ( )  ; 


*  Clears  all  stream  related  stats 

*/ 

private  void  clearStreamData ( ) { 

for(int  jj=0;  jj<5;  ++jj){ 
rText  [jj]  .setText ("") ; 

} 

f eedbkArea . setText ( " " ) ; 


I 
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*  Disable  user  input  components (  used  after  a  session  is  started  ) 
*/ 

private  void  disablelnputs ( ) { 

sessionText . setEnabled (false)  ; 

modifyPref . setEnabled ( false)  ; 

selectBm. setEnabled (false)  ; 
} 

/** 

*  Enable  user  input  components (  used  after  a  session  is  stoped  ) 
*/ 

private  void  enablelnputs ( ) { 

sessionText . setEnabled (true)  ; 

modifyPref . setEnabled (true) ; 

selectBm. setEnabled (true)  ; 
} 


/*  + 

*  Returns  the  state  of  RtpMonitor.  Also  exits  the  program  if  the  duration 

*  is  over. 

*  @return  true  if  the  monitor  is  active 
*/ 

public  boolean  isMonitoring ( ) ( 

if(  endDate . compareTo (new  Date ( ) )  <  0  ){ 

System. exit  (0)  ; 
} 

return  flgActive; 
} 

*  Creates  a  string  with  a  fixed  size,  starting  by  a  given  string  and  ending 

*  with  blank  spaces. 

*  @param  strin  the  original  string 

*  @param  size   the  final  size  of  the  returning  string 

*  @return  a  string 
V 

private  String   f illBlanks (  String  strin,  int  size  ) 
{ 

StringBuffer  spaces  =  new  StringBuf fer ( ) ; 

f or (  int  ii  =  0;  ii  <=  size;  ++ii  ) { 
spaces. append (  "  "); 

} 

String  newString  =  new  String (  strin  +  spaces  ) ; 

return  newString. substring (  0,  size); 
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*  Runs  an  external  program  specified  in  the  preference  menu 

*  to  display  output  files. 

*  @param  locator  the  session  RtpMediaLocator 

*  @param  fileName  the  name  of  the  file  to  be  displayed 
*/ 

private  void  runViewer (String  locator,  String  fileName) { 

String  prefix; 

Runtime  r  =  Runtime. getRuntime ()  ; 

try{ 

RtpMediaLocator  rtpml  =  new  RtpMediaLocator (locator) ; 

String  session  =  rtpml . getSessionAddress ()  ; 

String  port  =  (new  Integer (rtpml . getSessionPort ())). toString () ; 

String  dir  =  new  String (  "./session" 

+  session. replace ('.','-' )  +  "port"  +  port  ) ; 

prefix  =  new  String (  dir  +  "/statistics"  ); 
} 
catch  (MalformedURLException  e)  { 

System. out . println (  e . getMessage ( )  ); 

return; 
} 

try{ 

String  prog  =  new  String (  modPref Dialog. viewerText . getText ( )  +  "  "  + 

prefix  +  fileName  ) ; 
Process  p  =  r. exec (prog) ; 

} 

catch  (  IOException  e) { 

System. err .println (  e . getMessage ( )  ); 
} 


*  Method  called  upon  executing  class  RtpMonitor.  If  there  is  no 

*  argument  an  object  of  class  RtpMonitor  will  be  instantiated 

*  and  executed,  otherwise  the  same  will  happen  with  an 

*  RtpMonitorCommandLine  object. 
*/ 

public  static  void  main (  String  []  args  ) 
{ 

int  nArgs  =  args. length; 

if (args . length  ==  0){ 

RtpMonitor  myProg  =  new  RtpMonitor () ; 
} 
else{ 

RtpMonitorCommandLine  myProg  =  new  RtpMonitorCommandLine (  args  ) 
myProg.run ( ) ; 
} 
} 

}  //  end  of  class  RtpMonitor 
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package  org. web3d. vrtp. rtp; 

import  j avax. media . rtp. *; 
import  j avax. media . rtp. event . *  ; 
import  j avax. media. rtp. rtcp. * ; 

import  java.io.*; 
import  java.net.*; 
import  java.util.*; 

/** 

*  A  class  used  to  start  a  RTP  monitor  from  command  line  inputs. 

*  <P> 

*  This  monitor  does  not  have  the  option  of  playing  streams. 
+ 

*  Sauthor   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  (aversion  1.0 
*/ 

public  class  RtpMonitorCommandLine  { 

boolean  willpart  =  false; 
boolean  willplay  =  false; 
boolean  willrecord  =  false; 
String  locator  =  null; 
double  interval  =  30.0; 
int  endsInHours  =  168; 
Date  endDate; 

RtpMonitorManager  monMgr; 

*  Method  called  upon  executing  class  RtpMonitorCommandLine. 

*/ 

public  static  void  main(String  []  args) { 

RtpMonitorCommandLine  myProg  =  new  RtpMonitorCommandLine (  args  ) ; 
myProg. run ( ) ; 

} 

I  -k  -k 

*  Constructor.  It  reads  the  command  line  arguments  and  sets 

*  variables  and  flags. 

*  The  command  line  arguments  have  the  following  format: 

*  <P> 

*  java  RtpMonitorCommandLine  rtpLocator  [options]  <P> 

*  rtpLocator  example:  rtp : //224 . 2 . 125 . 50 : 50328/127  <P> 

*  -part  :  monitor  sends  RTCP  packets  <P> 

*  -play  :  monitor  play  streams  <P> 

*  -record  :  monitor  records  statistics  <P> 

*  -i  nnn  :  nnn  defines  the  recording  interval  in  seconds  (default  30s)  <P> 

*  -e  ppp  :  ppp  defines  the  monitoring  duration  in  hours  (default:  168 

*  hs)<P> 

*  -help   :  displays  command  line  format  and  aborts 
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*  <p> 

*  @param  args  an  array  of  strings 
*/ 

public  RtpMonitorCommandLine (String  []  args){ 

int  nArgs  =  args. length; 

if (  nArgs  ==  0)  { 

System. out . println ( 

"Format:  Java  RtpMonitorCommandLine  rtpLocator  <options>"); 
System. out . println ( 

"   rtpLocator  example:  rtp: //224 . 2 . 125 . 50 : 50328/127"  ); 
System. out . println ( 

"   options:  -part  :  monitor  sends  RTCP  packets"  ); 
System. out .println ( 

"  -play  :  monitor  play  streams") ; 

System. out .println ( 

"  -record  :  monitor  records  statistics"); 

System. out . println ( 

"  -i  nnn  :  nnn  defines  the  recording  interval  in  seconds 

(default  30s) ")  ; 
System. out .println  ( 

"  -e  ppp  :  ppp  defines  the  monitoring  duration  in  hours 

(default:  168  hs) ")  ; 
System. out .println ( 

"  -help   :  displays  command  line  format  and  aborts  "); 

System. exit  (0)  ; 
} 

if(  args[0] . indexOf ("-help")  ==  0  )  { 
System. out .println ( 

"Format:  Java  RtpMonitorCommandLine  rtpLocator  <options>"); 
System. out .println ( 

"   rtpLocator  example:  rtp: //224 . 2 . 125 . 50 : 50328/127"  ); 
System. out .println ( 

"   options:  -part  :  monitor  sends  RTCP  packets"  ); 
System. out .println ( 

"  -play  :  monitor  play  streams"); 

System. out .println ( 

"  -record  :  monitor  records  statistics"); 

System. out .println ( 

"  -i  nnn  :  nnn  defines  the  recording  interval  in  seconds 

(default  30s)  ")  ; 
System. out .println  ( 

"  -e  ppp  :  ppp  defines  the  monitoring  duration  in  hours 

(default:  168  hs) ") ; 
System. out .println ( 

"  -help   :  displays  command  line  format  and  aborts  "); 

System. exit  (0)  ; 
} 

//  parses  the  command  line  arguments  to  extract  the  options 

locator  =  args[0]; 

int  ii  =  1; 

while (  ii  <  nArgs  )  { 

if(  args [ii] . indexOf ( "-part")  ==  0  )  { 
willpart  =  true; 
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} 

else  if(  args [ii] . indexOf ("-play")  ==  0  )  { 
willplay  =  true; 

} 

else  if(  args [ii] . indexOf ( "-record")  ==  0  )  { 

willrecord  =  true; 
} 
else  if(  (args [ii] .indexOf ("-i")  ==  0)  &&  (ii  <  nArgs  -1)  )  { 

interval  =  Double .parseDouble (args [ii+1] ) ; 
} 
else  if(  (args [ii] .indexOf ("-e")  ==  0)  &&  (ii  <  nArgs  -1)  )  { 

endsInHours  =  Integer .parselnt (args [ii+1] ) ; 
} 
ii  +  +; 


endDate  =  new  Date (  (new  Date ( ) ) . getTime ( )  +  endsInHours*3600000L)  ; 

//  displays  the  selected  options  on  the  console 
System. out .println ( "locator   =  "  +  locator  ); 
System. out . println ( "play  =  "  +  willplay  ); 
System. out .println ("part  =  "  +  willpart  ); 
System. out .println ( "record   =  "  +  willrecord  ); 

System. out .println ( "recording  interval  =  "  +  interval  +  "  seconds."  ); 
System. out .println ("monitoring  duration  =  "  +  endsInHours  +  "  hours."  ) 
} 


*  Method  that  will  create  the  RtpMonitorManager  object  and  will  exit  the 

*  program  when  the  user  defined  duration  is  elapsed. 
*/ 

public  void  run ( ) { 

//  tries  to  create  the  RtpMonitorManager  object 
try{ 

monMgr  =  new  RtpMonitorManager (locator,  willpart,  willplay, 

willrecord,  interval) ; 
} 

catch (  Malf ormedURLException  e  ){ 

System. err .println ( 

"MalformedRTPMRLException  creating  RTPMonitorManager :  "  ); 

System. err .println (  e . getMessage ( )  ); 

System. exit (0 ) ; 
} 
catch (UnknownHostException  e  ){ 

System. err .println ( 

"UnknownHostException  creating  RTPMonitorManager:  "  ); 

System. err .println (  e . getMessage ( )  ); 

System. exit (0)  ; 
} 
catch (  SessionManagerException  e  ){ 

System. err .println ( 

"RTPSessionManagerException  creating  RTPMonitorManager:  "  ); 

System. err .println (  e . getMessage ( )  ); 
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System. exit  (0) ; 

} 

catch  (  IOException   e  ){ 

System. err .println ( "IOException  creating  RTPMonitorManager :  "  ) ; 

System. err . println (  e . getMessage ( )  ); 

System. exit  (0) ; 
} 

//  runs  until  the  user  aborts  the  program  (ctrl-C)  or  the 
//  monitoring  period  is  over 
while (true) { 

//  tests  if  the  monitoring  period  is  over 
if(  endDate . compareTo (new  Date ( ) )  <  0  ){ 

System. exit (0) ; 
} 

try{ 

Thread. sleep(50000)  ; 

} 

catch  (InterruptedException  e){} 

} 
} 
}  //  end  of  class  RtpMonitorCommandLine 
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package  org . web3d. vrtp. rtp; 

import  j avax. media . rtp. * ; 
import  j avax. media. rtp. event . *; 
import  j avax. media . rtp. rtcp. *; 

//  RTPSessionMgr  class 

import  com. sun. media . rtp. *; 

import  java.io.*; 

import  java.net.*; 

import  java.util.*; 

import  j avax. media . *; 

import  j avax. media .protocol . *; 

*  A  class  that  encapsulates  all  operations  necessary  to  start  a  new 

*  monitoring  session,  play  its  streams,  and  record  statistical  data. 

*  <P> 

*  This  class  does  not  display  statistics  on  screen.  That  must  be  done 

*  by  another  class,  usually  a  frame,  using  data  from  a  SessionManager 

*  object  (  see  method  getSessionManager  ) . 
* 

*  @author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  ©version  1.0 
*/ 

public  class  RtpMonitorManager  implements  ReceiveStreamListener  { 

private  RtpMediaLocator  rtpml  =  null; 
private  SessionManager  mgr  =  null; 
private  SessionAddress  sessaddr  =  null; 
private  boolean  flgPart; 
private  boolean  flgPlay; 
private  boolean  flgRecord; 
private  Hashtable  windowlist; 
private  RecordTask  recTask; 

*  @param  locatorString  the  session  description  string 

*  format,  e.g.  rtp: //224 . 2 . 134 . 67 : 50980/127 

*  <P> 

*  @param  willParticipate 

*  true  if  the  Monitor  will  participate  in  the  session, 

*  sending  RTCP  packets,  false  otherwise. 

*  <P> 

*  @param  willPlayStreams  true  if  the  Monitor  will  play  the 

*  receiving  streams,  false  otherwise. 

*  <P> 

*  @param  willRecord  true  if  the  Monitor  will  record  statistical 

*  data  about  the  session,  false  otherwise. 

*  <p> 

*  @param  recordlnterval  the  time  between  data  recordings  in  seconds 

*  @exception  MalformedURLException 

*  if  the  locatorString  argument  does  not  conform  to  the  syntax, 

*  <P> 

*  @exception  UnknownHostException 

*  if  InetAddress . getByName (session  address)  fails 

*  <P> 
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*  @exception  SessionManagerException 

*  Exception  thrown  when  there  is  an  error  starting  an 

*  RTPSessionManager 
+  <P> 

*  @exception  IOException 

*  Exception  thrown  when  there  is  an  error  in  RTPSessionManager 
*/ 

public  RtpMonitorManager (  String  locatorString,  boolean  willParticipate, 

boolean  willPlayStreams,  boolean  willRecord  , 
double  recordlnterval) 
throws  Malf ormedURLException,  UnknownHostException, 
SessionManagerException,  IOException 


{ 


flgPart  =  willParticipate; 
flgPlay  =  willPlayStreams; 
flgRecord  =  willRecord; 

//  creates  the  RtpMediaLocator  object 
rtpml  =  new  RtpMediaLocator (locatorString) ; 

//  creates  an  empty  RtpSessionManager  object 
mgr  =  new  RTPSessionMgr ( ) ; 

//  if  the  user  select  to  play  the  streams,  registers  as  a 
//  listener  for  received  streams 
if (flgPlay) { 

mgr . addReceiveStreamListener (this) ; 

windowlist  =  new  Hashtable ( ) ; 


//  gets  the  InetAddress  of  the  session 

InetAddress  destaddr  =  InetAddress . getByName (rtpml . getSessionAddress 

//  gets  the  session  port 

int  port  =  rtpml . getSessionPort  () ; 

//  creates  a  SessionAddress  objet  to  represent  the  session 
sessaddr  =  new  SessionAddress  (  destaddr,  port,  destaddr,  port+1  ) ; 

//  call  the  method  to  generate  a  CNAME  for  the  user 
String  cname  =  mgr . generateCNAME ( ) ; 

//  gets  the  username  from  the  system  and  adds  it  to 

//  the  string  "/rtpMonitor" .  That  will  be  the  user  name  sent  in 

//  RTCP  packets 

String  username  =  null; 

try{ 

username  =  System. getProperty ( "user . name" ) +  "/rtpMonitor"; 

} 

catch (SecurityException  e)  { 

username  =  "RTPMonitor-user"; 
} 

//  creates  the  source  description  fields 

SourceDescription  []  userdesclist  =  new  SourceDescription [3] ; 

userdesclist [0]  =  new 
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SourceDescription (  SourceDescription. SOURCE_DESC_NAME, 

username,  1,  false) ; 
userdesclist [1]  =  new 

SourceDescription (  SourceDescription . SOURCE_DESC_CNAME, 

cname,  1,  false); 
userdesclist [2]  =  new 

SourceDescription (  SourceDescription . SOURCE_DESC_TOOL, 

"RTPMonitor  vl.O"  ,  1,  false); 

//  generates  a  local  address 

SessionAddress  localaddr  =  new  SessionAddress () ; 

//  that  is  the  fraction  of  RTCP  bandwith  compared  to  RTP 
double  rtcpFraction  =  0.05; 

//  if  the  user  has  selected  for  no  participation  in  the  session, 
//  sets  the  fraction  above  to  zero  (  no  RTCP  packets  ) 
if(  !  flgPart  ) 

rtcpFraction  =  0.0; 

//  initiates  the  SessionManager  object 

mgr . initSession (  localaddr,  userdesclist,  rtcpFraction  ,  0.25  ); 

int  ttl  =  rtpml.getTTLO  ; 

//  starts  the  SessionManager  object 
mgr . startSession (  sessaddr,  ttl,  null); 

//  if  the  user  has  selected  for  recording  statistics,  creates  a 
//  RecordTask  objet  to  generate  the  reports  periodically 
if (flgRecord) { 

recTask  =  new  RecordTask (  this,  recordlnterval  ); 

} 


/*  * 

*  Method  of  classes  that  implement  the  ReceiveStreamListener 

*  interface 
* 

public  void  update  (  ReceiveStreamEvent  event) { 
Player  newPlayer  =  null; 
RtpPlayerWindow  playerWindow  =  null; 
String  cname  =  null; 

SessionManager  source  =  (SessionManager)  event . getSource () ; 

//  if  a  new  stream  is  received 

if(  event  instanceof  NewReceiveStreamEvent ) { 

//  gets  the  ReceiveStream  object 
try{ 

ReceiveStream  stream  = 

( (NewReceiveStreamEvent ) event ) . getReceiveStream ( ) ; 
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//  gets  the  Participant  object  associated  with  the  stream 
Participant  part  =  stream. getParticipant () ; 

//  gets  the  participant  canonical  name 
if (part  !=  null) { 

cname  =  part . getCNAME ( ) ; 
} 

//  gets  the  stream  DataSource  associated  with  the  stream 
DataSource  dsource  =  stream. getDataSource ()  ; 

//  creates  a  player  to  play  the  DataSource 
newPlayer  =  Manager . createPlayer (dsource) ; 

//  if  a  player  was  created  generates  a  player  window 
if (newPlayer  !=  null){ 

playerWindow  =  new  RtpPlayerWindow (  newPlayer,  cname); 

windowlist .put (  stream,  playerWindow); 
} 

} 

catch  (Exception  e) { 

System. err .println ( 

"NewRecvStreamEvent  exception  "  +  e . getMessage ( )  ); 
return; 
} 
} 

//  if  the  sender  of  a  stream  was  identified 
if (  event  instanceof  StreamMappedEvent) { 

//  gets  the  ReceiveStream  object 
ReceiveStream  stream  = 

( (StreamMappedEvent ) event ) . getReceiveStream ( ) ; 

//  gets  the  Participant  associated  with  the  stream 
Participant  part  =  stream. getParticipant () ; 

//  retrieves  the  correct  player  window  from  the 

//  hash  table 

if (stream  !=  null){ 

playerWindow  =  (RtpPlayerWindow)  windowlist . get (stream) ; 
} 

//  change  the  title  of  the  player  window  to  include  the 

//  name  of  the  sender 

if(  (playerWindow  !=  null)  &&  (part  !=  null)){ 

playerWindow. Name (part . getCNAME ( ) ) ; 
} 
} 
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*  Closes  a  monitor  session,  stops  recording  and  closes  player  windows 

*/ 

public  void  close (){ 

if (flgRecord) { 

recTask. exit  ( ) ; 
} 

if (flgPlay) { 

Enumeration  windows  =  windowlist . elements () ; 
while (  windows . hasMoreElements ( ) ) { 
RtpPlayerWindow  currwindow  = 

(RtpPlayerWindow)  windows . nextElement ( ) ; 
if (  currwindow  !=  null){ 

currwindow. killThePlayer ( )  ; 
} 
} 
} 

mgr . closeSession (null )  ; 
mgr  =  null; 


*  Returns  the  RtpMediaLocator  associated  with  the  RTP  session 

*  @return  the  session  media  locator 
*/ 

public  RtpMediaLocator    getMediaLocator ( ) {  return  rtpml; } 

*  Returns  the  SessionManager  object  created  by  the  monitor 
* 

*  @return  the  SessionManager  (RTPSessionMgr ) 
*/ 

public  SessionManager  getSessionManager ( ) {  return  mgr;} 

*  Returns  the  SessionAddress  object  associated  with  the  RTP  session 

*  @return  the  SessionAddress 
*/ 

public  SessionAddress  getSessionAddress ( ) {  return  sessaddr; } 


//  end  of  class  RtpMonitorManager 
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package  org. web3d. vrtp. rtp; 


*  @  (#)RTPPlayerWindow. Java    1.7  98/03/28 

* 

*  Copyright  1996-1998  by  Sun  Microsystems,  Inc., 

*  901  San  Antonio  Road,  Palo  Alto,  California,  94303,  U.S.A. 

*  All  rights  reserved. 
+ 

*  This  software  is  the  confidential  and  proprietary  information 

*  of  Sun  Microsystems,  Inc.  ("Confidential  Information").   You 

*  shall  not  disclose  such  Confidential  Information  and  shall  use 

*  it  only  in  accordance  with  the  terms  of  the  license  agreement 

*  you  entered  into  with  Sun. 
*/ 

import  javax. media . Player; 

import  java.awt.*; 

import  com. sun. media . ui . *; 

*  This  class  is  used  to  create  a  window  for  playing  an  audio/video 

*  stream.  It  is  a  subclass  of  PlayerWindow,  that  added  the 

*  capacity  of  modifying  the  window  name. 

*  Both  classes  were  developed  by  SUN.  RTPPlayerWindow  came  with 

*  JMF1 . 1  sample  code  and  PlayerWindow  is  in  the  file  JMF.jar. 
*/ 

public  class  RtpPlayerWindow  extends  PlayerWindow  { 

public  RtpPlayerWindow (Player  player,  String  title)  { 

super (player) ; 

setTitle (title) ; 
} 
public  void  Name (String  title) { 

setTitle (title) ; 
} 

}  //  end  of  class  PlayerWindow 
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package  org. web3d. vrtp. rtp; 

import  j avax. media . rtp .* ; 
import  javax. media . rtp. event . *; 
import  j avax .media. rtp. rtcp. *; 

import  Java . util . *; 

*  A  class  with  some  RTP  utilities  (static  methods) 

■*• 

*  @author      Francisco  Afonso    (afonso@cs.nps.navy.mil) 

*  (Aversion    1 .  0 
*/ 

public  class  RtpUtil 

{ 

*  Returns  the  participant  username 
* 

*  @param  part  the  Participant  object 
* 

*  Qreturn  a  string  with  the  participant's  username 
*/ 

public  static  String  getUsername ( Participant  part){ 


Vector  sdeslist  =  part . getSourceDescription ( ) ; 
if(sdeslist  ==  null) { 

return  null; 
} 

SourceDescription  des; 

f or (  int  ii=0;  ii  <  sdeslist . size  () ;  +  +  ii){ 

des  =  (SourceDescription)  sdeslist . elementAt (ii ) ; 

if(  des.getTypeO  ==  SourceDescription. SOURCE_DESC_NAME  ){ 
return  des . getDescription ( ) ; 

} 
} 
return  null; 
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*  Returns  the  participant's  username  or  his  CNAME, 

*  if  no  username  is  known. 
* 

*  Sparam  part  the  Participant  object 
* 

*  @return  a  string  with  the  participant's  username  or  CNAME 
*/ 

public  static  String  getUsernameOrCNAME (Participant  part){ 
String  username  =  getUsername (part ) ; 
if (username  ==  null){ 

return  part . getCNAME ( ) ; 
} 

else{ 

return  username; 
} 
} 


*  Converts  an  number  represented  as  a  signed  integer (32  bits) 

*  to  a  long  integer  (64  bits) .  JMF  methods  return  the  SSRC  as  an 

*  integer.  As  the  SSRC  is  a  32  bits  number,  some  are  represented 

*  in  JMF  as  negative  integers. 

*  This  convertion  is  necessary  to  present  SSRCs  as  a  positive  integer. 
*/ 

public  static  long  correctSSRC (  long  ssrc  ){ 
if (ssrc  <  0) { 

return  (4294967296L  +  ssrc) ; 

} 

return  ssrc; 

) 


}  //  end  of  class  RtpUtil 
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package  org. web3d. vrtp. rtp; 

import  Java. awt.*; 
import  Java . awt . event . * ; 
import  java . util . * ; 
import  java.io.*; 

*  A  Dialog  to  select  a  session  bookmark.  It  displays  a  list  choice 

*  of  session  names. 

*  <P> 

+ 

*  @author   Francisco  Afonso  (afonso@cs.nps.navy.mil) 

*  Aversion  1.0 
*/ 

public  class  SelectBookmark  extends  Dialog  implements  ItemListener  • 

j ava. awt .List  sessionNamesList ; 
Vector  sessionAddressVec; 
RtpMonitor  theParent; 

*  Constructor. 

*  <P> 

*  @param  parent  the  parent  frame 
*/ 

public  SelectBookmark (Frame  parent)! 

super (  parent,  "Select  Bookmark"  ,  true  ); 
setSize (  250  ,  200  ) ; 

theParent  =  (RtpMonitor)  parent; 

addWindowListener (  new  CloseWindow ( )  ) ; 

sessionNamesList  =  new  j ava . awt . List (  5  ,  false); 

loadBookmarks ( ) ; 

sessionNamesList . setBackground (Color . lightGray) ; 
sessionNamesList . addltemListener (this) ; 

add (sessionNamesList ) ; 
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*  Activated  when  a  bookmark  choice  is  made. 

*  <P> 

*  @param  parent  the  parent  frame 
*/ 

public  void  itemStateChanged (  ItemEvent  e)  { 

int  index  =  sessionNamesList . getSelectedlndex ( ) ; 
theParent . sessionText . setText ( 

(String)  sessionAddressVec. elementAt (index)   ); 
theParent . sessionNameText . setText ( 

sessionNamesList . getltem (index)  ) ; 
setVisible (false) ; 


*  Loads  the  session  bookmarks  from  file  "bookmarks.txt" 
*/ 
private  void  loadBookmarks ( ) { 

sessionAddressVec  =  new  Vector (); 

try{ 

Buf f eredReader  input  = 

new  Buf f eredReader (  new  FileReader ( "bookmarks . txt")  ); 
String  line; 

while (  (line  =  input . readLine () )  !=  null) { 
int  pos  =  line.lastlndexOf ("rtp: //") ; 
if  (pos  !=  -1) { 

sessionAddressVec . addElement (  line . substring (pos)  ) ; 
sessionNamesList . add (  line. substring (  0  ,  pos  )  ); 
} 
} 

input . close ( ) ; 
} 
catch  (  FileNotFoundException  e) { 

System. out .println (  "Select  Bookmark:  "  +  e . getMessage ( )  ) ; 
} 

catch  (  IOException  e) { 
System. err .println ( 

"Exception  reading  bookmark:  "  +  e . getMessage ( )  ); 
} 

} 

}   //  end  of  class  SelectBookmark 
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APPENDIX  E.    COMPARISON  RTP  MIB  VERSUS  JMF  STATISTICS 
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APPENDIX  F.  RTPHEADERJAVADOC 
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Class  Tree  Deprecated  Index  Help 

PREV  CLASS    NEXT  CLASS 
SUMMARY:   INNER  |  FIELD  |  CONSTR  |  METHOD 


FRAMES     NO  FRAMES 

DETAIL:   FIELD  |  CONSTR  |  METHOD 


mil.navy.nps.dis 

Class  RtpHeader 

Java . lang . Object 
I 
+--mil . navy . nps . dis . PduElement 

+--mil . navy . nps . dis . RtpHeader 


public  class  RtpHeader 

extends  mil.navy.nps.dis.PduElement 

This  class  encapsulates  the  header  of  the  Real-time  Transport  Protocol  (RTP)  when  used  to 
transfer  DIS  packets  as  a  payload. 

Version: 

1.0 
Author: 

Francisco  Afonso  (afonso@cs.nps.navy.mil) 
References: 

RTP:  (RFC  1889)  http://www.ietf.org/intemet-drafts/draft-ietf-avt-rtp-new-04.txt 


Field  Summary 

static    int 

RTP   CSRC   COUNT 

Contains  the  number  of  contributing  source  identifiers  in  this  header. 

static   int 

RTP   EXTENSION 

The  extension  bit  defines  if  the  normal  header  will  be  followed  by  an 
extension  header. 

static   int 

RTP   MARKER 

This  bit  is  used  as  a  marker  by  a  specific  profile  or  application. 

static   int 

RTP    PADDING 

Padding  is  being  performed  at  the  DIS  protocol  level. 

static    int 

RTP    PAYLOAD    TYPE    FOR  DIS 

The  payload  type  number  was  set  to  111. 

static   int 

RTP   VERSION 

Identifies  the  version  of  RTP  (2  bits). 

static   int 

sizeOf 

Contains  the  size  of  the  header  in  bytes  (=  12). 
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Constructor  Summary 


RtpHeader ( ) 

Constructor. 


Method  Summary 

java . lang. Object 

clone ( ) 

Makes  deep  copies  of  all  the  instance  variables. 

void 

deSerialize ( j ava . io . DatalnputStream   inputStream) 

Fills  the  header  contents  with  data  from  a 
DatalnputStream 

mil. navy . nps . util . UnsignedShort 

getSeguenceNumber ( ) 

Returns  the  packet  sequence  number. 

mil . navy. nps .util . Unsignedlnt 

getSSRC ( ) 

Returns  the  packet  Syncronization  Source  Identifier. 

mil . navy. nps .util . Unsignedlnt 

getTime stamp ( ) 

Returns  the  packet  timestamp. 

int 

length ( ) 

Returns  the  size  of  the  header. 

void 

prepareToSend 

(mil . navy . nps . dis . ProtocolDataUnit   pdu) 

Prepares  the  header  for  sending. 

void 

printValues ( int    indentLevel , 

Java. io. PrintStream  printStream) 
Prints  internal  values  for  debugging. 

void 

serialize ( j  ava . io . DataOutputStream   outputStream) 

Serializes  the  header  into  a  DataOutputStream. 

void 

setSequenceNumber 

(mil . navy. nps . util . UnsignedShort   pSequenceNumber) 
Sets  the  packet  sequence  number. 

void 

setSSRC (mil . navy . nps . util . Unsiqnedlnt   pSSRC) 

Sets  the  Syncronization  Source  Identifier. 

void 

setTimestamp 

(mil . navy . nps . util . Unsignedlnt   pTimestamp) 

Sets  the  packet  timestamp. 

Methods  inherited  from  class  java.lang.Object 


equals,    finalize,    getClass,    hashCode,    notify,    notifyAll,    toString,    wait, 
wait,    wait 


Field  Detail 
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RTP_VERSION 

public  static  final  int  RTP_VERSION 

Identifies  the  version  of  RTP  (2  bits).  RFC  1889  defines  the  actual  version  as  two(2). 


RTP_PADDING 

public  static  final  int  RTP_PADDING 

Padding  is  being  performed  at  the  DIS  protocol  level.  Therefore  the  padding  bit  is  set  to 
zero. 


RTP_EXTENSION 

public  static  final  int  RTP_EXTENSION 

The  extension  bit  defines  if  the  normal  header  will  be  followed  by  an  extension  header. 
Not  needed  in  this  application,  and  so  set  to  zero. 


RTP_CSRC_COUNT 

public  static  final  int  RTP_CSRC_COUNT 

Contains  the  number  of  contributing  source  identifiers  in  this  header.  This  is  used  only 
by  mixers.  Set  to  zero. 


RTP_MARKER 

public  static  final  int  RTP_MARKER 

This  bit  is  used  as  a  marker  by  a  specific  profile  or  application.  Not  used  so  far.  Set  to 
zero. 


RTP_PAYLOAD_TYPE_FOR_DIS 

public  static  final  int  RTP_PAYLOAD_TYPE_FOR_DIS 

The  payload  type  number  was  set  to  111.  It  belongs  to  the  dynamic  assignment  range 
(96-127).  Numbers  in  this  range  do  not  need  to  be  registered. 
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See:  http://www.ietf.org/internet-drafts/draft-ietf-avt-profile-new-06.txt  -  Session  3. 
sizeOf 

public    static    final    int    sizeOf 

Contains  the  size  of  the  header  in  bytes  (=  12). 


Constructor  Detail 


RtpHeader 

public  RtpHeader ( ) 

Constructor.  An  empty  header  is  created. 


Method  Detail 


getSequenceNumber 

public  mil .  navy .  nps  .  util .  UnsignedShort  getSequenceNninher 

Returns  the  packet  sequence  number. 
Returns: 

the  sequence  number  as  an  unsigned  short  ( 1 6  bits) 

getTimestamp 

public   mil . navy . nps . util . Unsignedlnt   getTimestamp ( ) 

Returns  the  packet  timestamp. 
Returns: 

the  timestamp  as  an  unsigned  int  (32  bits) 

getSSRC 

public   mil .navy. nps. util. Unsignedlnt   getSSRC ( ) 

Returns  the  packet  Syncronization  Source  Identifier. 
Returns: 

the  SSRC  as  an  unsigned  int  (32  bits) 
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setSequenceNumber 

public  void  setSequenceNumber (mil . navy .nps . util . UnsignedShort  pSequenceNumber 

Sets  the  packet  sequence  number. 
Parameters: 

pSequenceNumber  -  the  sequence  number  as  an  unsigned  short  (16  bits) 

setTimestamp 

public   void   setTimestamp (mil . navy . nps . util . Unsignedlnt   pTimestamp) 

Sets  the  packet  timestamp. 
Parameters: 

pTimestamp  -  the  timestamp  as  an  unsigned  int  (32  bits) 

setSSRC 

public  void  setSSRC (mil . navy . nps . util . Unsignedlnt  pSSRC) 

Sets  the  Syncronization  Source  Identifier. 
Parameters: 

pSSRC  -  the  SSRC  as  a  unsigned  int  (32  bits) 

prepareToSend 

public   void  prepareToSend (mil . navy . nps . dis . ProtocolDataUnit   pdu) 

Prepares  the  header  for  sending.  Assigns  the  sequencial  number  from  a  static  variable, 

takes  the  timestamp  from  the  DIS  pdu  and  sets  the  SSRC. 

Parameters: 

pdu  -  the  DIS  pdu  that  will  be  transmitted 

length 

public   int    length ( ) 

Returns  the  size  of  the  header. 
Overrides: 

length  in  class  mil. navy .nps.dis.PduElement 
Returns: 

the  header  size 
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serialize 

public  void  serialize (Java . io . DataOutputStream  outputStream) 

Serializes  the  header  into  a  DataOutputStream. 
Overrides: 

serialize  in  class  mil.navy.nps.dis.PduElement 
Parameters: 

outputStream  -  the  stream  that  will  receive  the  serialized  header. 


deSerialize 

public  void  deSerialize (Java . io . DatalnputStream  inputStream) 

Fills  the  header  contents  with  data  from  a  DatalnputStream 
Overrides: 

deSerialize  in  class  mil.navy.nps.dis.PduElement 
Parameters: 

inputstream  -  the  stream  which  contains  the  header. 

clone 

public  Java . lang. Object  clone ( ) 

Makes  deep  copies  of  all  the  instance  variables. 
Overrides: 

clone  in  class  mil.navy.nps.dis.PduElement 

printValues 

public  void  printValues ( int  indentLevel, 

Java . io. PrintStream  printStream) 

Prints  internal  values  for  debugging. 
Overrides: 

printValues  in  class  mil.navy.nps.dis.PduElement 

Class  Tree  Deprecated  Index  Help 

PREV  CLASS    NEXT  CLASS  FRAMES     NO  FRAMES 

SUMMARY:   INNER  |  FIELD  I  CONSTR  |  METHOD  DETAIL:   FIELD  1  CONSTR  |  METHOD 
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APPENDIX  G.  RTPHEADER  SOURCE  CODE 

package   mil .navy . nps . dis; 

import   mil . navy . nps . util .  * ; 
import    java.io.*; 

/** 

*  This  class  encapsulates  the  header  of  the  Real-time  Transport  Protocol  (RTP) 

*  when  used  to  transfer  DIS  packets  as  a  payload. 

*  (Aversion    1.0 

*  @author    Francisco  Afonso    (afonso@cs.nps.navy.mil) 
* 

*  <dtxb>References:</b> 

*  <dd>RTP:  (RFC1889)  <a  href="http: //www. ietf . org/internet-draf ts/draf t-ietf- 

*  avt-rtp-new-04 . txt"> 

*  http: //www. ietf. org/internet-draf ts /draft -ietf -avt-rtp-new-04 . txt</a> 
* 

V 

public  class  RtpHeader  extends  PduElement 
{ 

//  this  SSRC  will  be  used  for  all  transmitted  packets 

private  static  long  mySSRC; 

//  this  variable  contains  the  next  sequence  number  of  a  transmitted  packet 
private  static  int   nextSequenceNumber; 

static 
{ 

//  assigns  a  random  integer  to  the  SSRC 

mySSRC   =  (long) (  Math. random ( )  *  Unsignedlnt .MAX_INT_VALUE  ); 

//  assign  a  random  integer  to  the  first  sequence  number 

nextSequenceNumber  =  (int ) (Math. random () *UnsignedShort .MAX_SHORT_VALUE  ) ; 
} 


*  Identifies  the  version  of  RTP  (2  bits) .  RFC1889  defines  the  actual 

*  version  as  two(2). 
* 

*/ 

public  static  final  int  RTP_VERSION  =  2; 
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/■*•■*• 

*  Padding  is  being  performed  at  the  DIS  protocol  level. 

*  Therefore  the  padding  bit  is  set  to  zero. 

*/ 

public  static  final  int  RTP_PADDING  =  0; 

/*  * 

*  The  extension  bit  defines  if  the  normal  header  will  be  followed 

*  by  an  extension  header. 

*  Not  needed  in  this  application,  and  so  set  to  zero. 

*/ 

public  static  final  int  RTP_EXTENSION  =  0; 

*  Contains  the  number  of  contributing  source  identifiers  in  this  header. 

*  This  is  used  only  by  mixers.  Set  to  zero. 

*/ 

public  static  final  int  RTP_CSRC_COUNT  =  0; 

*  This  bit  is  used  as  a  marker  by  a  specific  profile  or 

*  application. 

*  Not  used  so  far.  Set  to  zero. 

■*• 

*/ 

public  static  final  int  RTP_MARKER  =  0; 

*  The  payload  type  number  was  set  to  111. 

*  It  belongs  to  the  dynamic  assignment  range  (96-127). 

*  Numbers  in  this  range  do  not  need  to  be  registered.  <p> 

*  See:  <a  href="http: //www. ietf . org/internet-drafts/draft-ietf-avt-profile- 

*  new-06.txt"> 

*  http: //www. ietf . org/internet-draf ts/draft-ietf-avt-prof ile-new-06 . txt</a> 

*  -  Session  3. 
* 

*/ 

public  static  final  int  RTP_PAYLOAD_TYPE_FOR_DIS  =  111; 
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*  Contains  the  size  of  the  header  in  bytes  (=  12) . 
*/ 
public  static  final  int  sizeOf  =  12; 

//  the  packet  sequence  number 
private  UnsignedShort  sequenceNumber; 

//  the  packet  timestamp 

private  Unsignedlnt    timestamp; 

//  the  packet  Sincronization  Source  Identifier  (SSRC) 
private  Unsignedlnt    SSRC; 


*  Constructor.  An  empty  header  is  created. 
*/ 
public  RtpHeader ( ) 
{ 

sequenceNumber  =  new  UnsignedShort ( ) ; 
timestamp  =  new  Unsignedlnt () ; 
SSRC      =  new  Unsignedlnt () ; 

return; 
} 


*  Returns  the  packet  sequence  number. 

*  Sreturn  the  sequence  number  as  an  unsigned  short  (16  bits; 
*/ 

public  UnsignedShort  getSequenceNumber ( ) 
{ 

return  ( UnsignedShort ) sequenceNumber . clone ( ) ; 
} 


*   Returns  the  packet  timestamp. 

.*   @return  the  timestamp  as  an  unsigned  int  (32  bits] 

V 

public  Unsignedlnt  getTimestamp ( ) 

{ 

return  (Unsignedlnt) timestamp. clone ( ) ; 
} 


*  Returns  the  packet  Syncronization  Source  Identifier. 

*  @return  the  SSRC  as  an  unsigned  int  (32  bits) 
*/ 

public  Unsignedlnt  getSSRCO 
{ 

return  (Unsignedlnt) SSRC. clone ( )  ; 
} 
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*  Sets  the  packet  sequence  number. 

*  @param  pSequenceNumber  the  sequence  number  as  an  unsigned  short 

*  (16  bits) 
*/ 

public  void  setSequenceNumber (UnsignedShort  pSequenceNumber) 
{ 

sequenceNumber  =  pSequenceNumber; 
} 


*  Sets  the  packet  timestamp. 

*  @param  pTimestamp  the  timestamp  as  an  unsigned  int  (32  bits) 
*/ 

public  void  setTimestamp (Unsignedlnt  pTimestamp) 
{ 

timestamp  =  pTimestamp; 


} 


/*  * 

*  Sets  the  Syncronization  Source  Identifier. 

*  @param  pSSRC  the  SSRC  as  a  unsigned  int  (32  bits] 
*/ 

public  void  setSSRC (Unsignedlnt  pSSRC) 

{ 

SSRC  =  pSSRC; 

} 


/*  * 

*  Increments  the  sequence  number.  The  RtpHeader  class  mantains  a  static 

*  variable  with  the  next  sequence  number  to  be  assigned  to  a  packet. 

*  This  function  increments  this  variable.  If  the  sequence  number  will 

*  exceed  the  32  bits  boundaries  it  is  set  to  zero. 
*/ 

private  void  incrementSequenceNumber ( ) 
{ 

//  if  after  the  increment  the  sequence  number  gets  longer  than  16 

bits 
//  than  it  should  be  set  to  zero 
++next SequenceNumber; 
if(  nextSequenceNumber  >  UnsignedShort .MAX_SHORT_VALUE  ){ 

next SequenceNumber  =  0; 
} 


return; 


} 
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*  Prepares  the  header  for  sending.  Assigns  the  sequencial  number  from 

*  a  static  variable,  takes  the  timestamp  from  the  DIS  pdu  and  sets  the  SSRC, 

*  @param  pdu  the  DIS  pdu  that  will  be  transmitted 
*/ 

public  void  prepareToSend (  ProtocolDataUnit  pdu  ) 
{ 

//  assigns  a  sequence  number  (the  next  sequence  number  kept  by  a 

static 
//  variable) 
sequenceNumber  =  new  UnsignedShort (  nextSequenceNumber  ) ; 

//  increments  the  next  sequence  number  variable 
incrementSequenceNumber ( ) ; 

//  assigns  as  a  timestamp  the  Dis-Java-Vrml  timestamp 
timestamp  =  pdu. getTimestamp ( ) ; 

//  assigns  the  common  SSRC 

SSRC  =  new  Unsignedlnt (  mySSRC  ) ; 

return; 


*  Returns  the  size  of  the  header. 

*  Sreturn  the  header  size 
*/ 

public  int  length ( ) 
{ 

return  RtpHeader . sizeOf ; 
} 

/  *  + 

*  Serializes  the  header  into  a  DataOutputStream. 

*  @param  outputStream  the  stream  that  will  receive  the  serialized  header. 
*/ 

public  void   serialize (DataOutputStream  outputStream) 
{ 

//  creates  the  first  and  second  byte  from  the  header 
UnsignedByte   firstByte  =  new  UnsignedByte (  (RTP_VERSION  *  64 )  + 

(RTP_PADDING  *  32)  +  (RTP_EXTENSION  *  16)  +  RTP_CSRC_COUNT  ) ; 
UnsignedByte   secondByte  =  new  UnsignedByte (  (RTP_MARKER  *  128  ) 
+  RTP_PAYLOAD_TYPE_FOR_DIS  ) ; 

//  serializes 

firstByte. serialize (outputStream) ; 

secondByte . serialize (outputStream) ; 

sequenceNumber . serialize (outputStream) ; 

timestamp . serialize (outputStream) ; 

SSRC. serialize (outputStream) ; 

return; 
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*  Fills  the  header  contents  with  data  from  a  DatalnputStream 

*  @param  inputStream  the  stream  which  contains  the  header. 
*/ 

public  void  deSerialize (DatalnputStream  inputStream) 
{ 

UnsignedByte  firstByte  =  new  UnsignedByte (0) ; 

UnsignedByte  secondByte  =  new  UnsignedByte (0 ) ; 

//  deserializes 

firstByte. deSerialize (inputStream) ; 
secondByte . deSerialize (inputStream) ; 
sequenceNumber . deSerialize (inputStream) ; 
timestamp. deSerialize (inputStream) ; 
SSRC. deSerialize (inputStream) ; 


return; 


} 


*   Makes  deep  copies  of  all  the  instance  variables. 
* 

*/ 

public  Object  clone  ( ) 
{ 

RtpHeader  newHeader  =  (RtpHeader) super . clone () ; 

newHeader . setSequenceNumber (this . getSequenceNumber ( ) ) ; 
newHeader . setTimestamp (this . getTimestamp ( ) ) ; 
newHeader. setSSRC (this . getSSRC ( )  )  ; 


return  newHeader; 


Prints  internal  values  for  debugging. 


*/ 

public  void  print Values (int  indentLevel,  PrintStream  printStream) 

{ 

StringBuffer  buf  = 

ProtocolDataUnit . get PaddingOf Length (indentLevel) ; 

printStream. println (buf  +  "sequenceNumber:  "  + 

sequenceNumber . intValue ( ) ) ; 
printStream. println (buf  +  "timestamp:  "  +  timestamp. longValue ()) ; 
printStream. println (buf  +  "SSRC:  "  +  SSRC. longValue ()) ; 

return; 
} 

}  //  end  of  class  RtpHeader 
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